Nothing but GIFs AGA

home *** CD-ROM | disk | FTP | other *** search

/ Nothing but GIFs AGA / Nothing But GIFs.iso / utility / pc-dos / gifv501.arj / GIFREED.DOC < prev next >

Wrap

Text File | 1993-10-11 | 290.1 KB | 6,646 lines

GIF-REED Version 5.01 The Image Viewer Image Printer Image Converter Image Cataloger Complete with PuzzleFun And Slide Shows By Software Matters Inc. (C)opyright 1993, 6352 N. Guilford Ave. Indianapolis, IN 46220 Order With 1-800-25-FLASH Technical Support With 1-317-253-8088 Table Of Contents Introduction 1 Credits 2 Shareware Concept 3 Reasons To Register Today 3 Reasons To Get PRO GIF-REED Today 5 Reasons To Get SYSOP GIF-REED Today 6 Licensed OEM version of GIF-REED 7 GIF-REED Version Comparisons 8 GIF-REED Update Policy 9 Purpose 10 GIF REED Program Features 10 File Formats Supported 10 Standard Features 10 Special Features 12 Slide Show Features 14 Picture Editing Features 14 File Management Features 16 Getting Started 17 Other Ways Of Loading GIF-REED 19 Loading Image Onto Screen Then Exit 20 Using The Script Language 21 System Requirements 22 Video Hardware Requirements 22 System MEMORY Requirements 22 Other Hardware Options 22 Misc. System Considerations 23 Getting MORE DOS RAM From GIF-REED 24 CD-ROM Support By GIF-REED 25 Files Needed/Used/Created By GIF-REED 26 Files Needed By GIF-REED 26 Documentation Files 26 Programs To Run 26 Sample Script Files 26 Sample GIF Files 26 Files Created & Used By GIF-REED 26 Temporary Files Created By GIF-REED 27 Files Created By YOU 27 TEMP Areas & Picture Buffer 28 What is a Color Map (Palette) 29 Keyboard Mouse Simulator 30 Keyboard Input Considerations 31 Path Lists (What good are they?) 32 Main File List Screen Layout 34 File List Menu Area 34 Status Area 34 Misc Info Area 34 Bottom Line Area 34 Main File List Menu Operation 36 Script File Viewer 44 Script File Editor 44 Mouse Operation At File List 47 Viewing Options 48 Color/Brightness Controls 48 Picture Movement 49 General Program Operations 49 File Operations 49 Image Control 50 Pixel Editor Screen Layout 50 Color Map Functions 51 Edit Screen Functions 52 Viewing Window Movement 52 Color Adjusting Function 53 Mouse Operation While Viewing 56 TRIM/CROP 56 ENLARGE 1 56 ENLARGE 2 56 ERASE BOX 57 BOX/LINE 57 Printing Operations 58 Print Quality 58 Setting Margins 58 Setting Printed Width 59 Choosing A Printer 59 Controlling Printer Output 59 Picking A Resolution 60 Other Commands 60 Controls while printing 60 Advanced Printing Capability 60 Special Printer Initialization 60 UNATTENDED Printing Of Multiple Files 62 BEST Printing Modes 62 Controlling Brightness and Contrast 63 Puzzle-Fun 64 Slide-It 64 JigSaw-It 64 Guess-It 64 General Operations 64 Scoring System 65 Slide Show Features/Operations 66 Features 66 Operations 68 Hints 68 Experienced Users 68 Catalog Features/Operations 70 Features 70 Operations 70 Making Catalogs From Command Line 70 Using Filters To Limit Pictures 72 Special Considerations 72 Making Catalogs From Files List Menu 73 Cataloging REQUIREMENTS 73 Exceptions To The Rule 74 Disk Space REQUIREMENTS 74 Hint Hint Hint 75 Using Your Catalogs 75 Select A Picture From A Catalog 75 Mark Files From Catalog For Copy 75 Special Notes 76 Using GIF-REED Under Windows 3.x 77 SYSOP GIF-REED 79 BBS Formats Supported 79 Example use with PCBOARD 80 Example use with WILDCAT! 81 Example using a BATCH FILE 81 Error Messages 83 Script Language Overview 86 Commands That Control Script Logic 88 Commands That Set & Display Variables & Messages 89 Command To Point To A Path 89 Commands To Do File Operations 89 Commands To Load Pictures 89 Commands To Control Slide Show Effects 89 Commands Used While Image Is Displayed 89 Commands To Control Printing 90 Commands To Control Mouse Operations 90 Commands To Control Debugging 90 General Purpose Commands 91 Commands That Change The NEXT Images Resolution 91 Complete Script Language Description 91 Commands That Control Script Logic 91 Commands That Set & Display Variables & Messages 93 System variables List 94 Commands To Point To A Path 95 Commands To Do File Operations 95 Commands To Load Pictures 96 Commands To Control Slide Show Effects 97 Commands Used While Image Is Displayed 97 Commands To Control Printing 100 Commands To Control Mouse Operations 101 Commands To Control Debugging 101 General Purpose Commands 101 Commands That Change The NEXT Images Resolution 102 GIF-REED HINTS 104 Operation HINTS 104 Hardware HINTS 105 Trouble Shooting / Questions & Problems 106 Glossary 109 GIF-REED 1 __________________________________________________________________________ Introduction Even though GIF-REED is easy to use and needs practically NO instructions at all, the following documentation should be helpful in clearing up any operations in the program that you are unsure of. This documentation also has some helpful hints on how to best use the program. The best way to fully explain the use of GIF-REED is to start by telling why GIF-REED was developed. GIF-REED was developed because all other GIF viewers have certain limitations that render them incapable of performing all of the tasks that I want to achieve. In other words I actually used 3 different programs on a regular basis. Out of all of the viewers only one of them loaded the pictures FAST. So naturally I used this one to display the pictures and do slide shows. Another viewer had poor display features but had superior printing capability. So naturally when I needed to print a picture I used that program. The last program I used on a frequent basis was one that actually shrunk the picture to fit the resolution of your video card. This was nice since (at that time) my video card had a maximum resolution of 640x400. That feature allowed me to view a 1024x768 picture with my 640x400 VGA card. This program, however, had bugs in it that caused some of the GIF89a extensions to crash the system. I liked the program so much, I called to register it. They sent me the registered version and poof, it still crashed. I called them back and found that the programmer doesn't spend much time on the program. So now I had a program that was unstable. Keeping various viewers around was a pain and learning each programs keystrokes was even more of an inconvenience. Therefore, I set out to write a viewer that encompassed all of the best features from the various viewers that I had used. I of course added some new features too. This way you only need to have ONE viewer and you can discard all of your other viewers. __________________________________________________________________________ 2 GIF-REED __________________________________________________________________________ Credits I would like to take this time to thank a few people for the development of this program, both in the user interface area and in just plain debugging of this program. Davie Reed: Did a great job programming all of the cool ideas presented by the picture viewing group. Carl Andrews: Offered great interface ideas, and simple debugging. He is a world class magician whose magic has been converted to software though his software publishing company called MoJo Software. His magic software can be purchased by calling (317) 257-8749 Mike Lawler: Offered advanced debugging, and attention to detail. Wendy Forrest: Offered user interface ideas as well as documentation editing. Mike Bianco: Offered user beta testing and some pretty cool ideas as well, such as adding comments to GIF files via the GIF89a specification! Bruce Felstein: User beta testing and some ideas for enhancements such as making the BOX routine ENLARGE the image if needed. Barb Brown: The blue pen proofing queen! Offered ideas for dumb users (such as herself), such as the glossary and the keyboard template. __________________________________________________________________________ GIF-REED 3 __________________________________________________________________________ Shareware Concept ======================================= | | | S H A R E W A R E - C O N C E P T | | | ======================================= GIF-REED is copyrighted software. However, you are encouraged to copy and share the NON-REGISTERED version with anybody keeping the following in mind: The NON-REGISTERED version of GIF-REED may be copied freely and given to others, as long as NO charge or compensation of ANY sort is required. It must be copied in its entirety with NO alterations to the programs or DOC files. It may be distributed by modem, as long as all files in the package are ZIPPED (or some equivalent) into one file. GIF-REED is NOT "FREE" software. If you use it past 30 days, you are required to pay for it by registering it. Of course you can register it earlier. ********** Reasons To Register Today ********** When you received this copy of GIF-REED, no monies were paid to us. In order for us to keep working on this product to make it better, with more features, we request that you register the program by paying for it. The registration charge is a very nominal $25 (The cost of ONE evenings entertainment!). Please print the ORDER.FRM file to register. When you register GIF-REED, you will receive a FREE keyboard template for common function keys reference. Of course the REGISTERED version has some enhancements over the NON-REGISTERED version. Below is a list of the extra features you receive with the REGISTERED version of GIF-REED: * You can use XMS memory for the Picture Buffer area. This makes GIF-REED faster for loading and displaying images. If you are currently using EMS memory for the Picture Buffer, XMS is about the SAME speed. But XMS is MUCH faster than using DISK space as the Picture Buffer. * You can save the following configuration items to a setup file for setting defaults: Display while loading or after loading EMS, XMS or DISK space for the Picture Buffer RESTORE Picture status SlideShow delay time SlideShow looping status SlideShow Special effects __________________________________________________________________________ 4 GIF-REED __________________________________________________________________________ Resolution Locking Status GIF Comments Display Status Video Hardware Setup Video resolutions available You can also save your directory paths. If you save your directory paths, the next time GIF-REED is loaded, the saved paths will be loaded again. This saves you time from having to type in all of the directory paths that you want loaded. After saving your video configuration, you will NOT need the environment variable GIFREED if you were previously using it. * You can MIRROR image the pictures * You can FLIP the image from top to bottom(upside down) * You can ROTATE the pictures in a clockwise direction in 90 degree increments. * You can use the DOS/BOSS key to shell out to a REAL DOS prompt at any time or if the BOSS comes in. * You can print ANY SIZE to an HP or EPSON printer. * You can create your own personalized slide shows through our ROBUST slide show script language. You can have multiple slide show setups for multiple slide show presentations that are setup before giving the presentation. The NON-REGISTERED version of GIF-REED only supports a limited command set in the script language! You get more script language commands. The extra commands you get in addition to the NON-REGISTERED version are: 1. PRINTER-ON 2. PRINTER-OFF 3. PRINTER-FF 4. IF-EXIST 5. SLIDE-TYPE-BLIND 6. SLIDE-TYPE-NORMAL 7. SLIDE-TYPE-FADE 8. SLIDE-TYPE-EXPAND 9. SLIDE-TYPE-MERGE 10. SLIDE-TYPE-ZEBRA 11. SLIDE-TYPE-RANDOM 12. MIRROR 13. FLIP 14. ROTATE 15. CENTER * You can have up to 512 files in the file list to choose from instead of 256 files. * You can create CATALOGS of images with sizes of 800x600 and up to 5 rows of thumbnail images. You can also have GIF-REED build catalogs of your image files through a single key command from the file list menu. * The time consuming registration screens are removed. __________________________________________________________________________ GIF-REED 5 __________________________________________________________________________ ********** Reasons To Get PRO GIF-REED Today ********** We also offer a PRO version of GIF-REED. This version has all of the features of the REGISTERED version plus a bunch more. The order fee is small $49.95 (The cost of ONE evenings deluxe entertainment!). Please print the ORDER.FRM file to ORDER. When you register GIF-REED, you will receive a FREE keyboard template for common function keys reference. Below is a list of the extra features you receive with the PRO version of GIF-REED: * You can actually edit your images. You can change each dot in the image to whatever color you like. You can even change the look of a particular color. In other words you could make blue in the image appear RED. * You get the FULL script language command set. The extra commands you get in addition to the REGISTERED version are: 1. SYSTEM 2. GOSUB 3. ECHO 4. FILE-COPY 5. FILE-MOVE 6. FILE-RENAME 7. FILE-DELETE 8. SORT-COLORS 9. EGA-MODE 10. VGA-MODE 11. EGA-COLOR-ADJUST 12. KEEP-SCREEN-SIZE 13. WRITE 14. PRINT 15. ADJUST-FOR-WINDOWS * You can make boxes of any color & thickness. * You can fill in boxes with any color * You can draw lines that are vertical or horizontal * You can load up to 3072 files in the file list to choose from. * You can load & edit images up to 8192 dots wide instead of 2048 dots wide. * If your VGA card supports more than 1024 dots wide PRO GIF- REED can take advantage of up to 2048 dots wide. * You can have up to 20 input directory paths * You can create CATALOGS of images with sizes of 2048x1536 and up to 10 rows of thumbnail images. You can also have GIF-REED build catalogs of your image files through a single key command from the main file list menu. * You can CENTER or give top and left margins for images that you print to your printer! __________________________________________________________________________ 6 GIF-REED __________________________________________________________________________ ********** Reasons To Get SYSOP GIF-REED Today ********** We also offer a SYSOP version of GIF-REED. This version has all of the features of the PRO GIF-REED version plus a bunch of SYSOP related features. The order fee is $89.95. Please print the ORDER.FRM file to ORDER. When you register GIF-REED, you will receive a FREE keyboard template for common function keys reference. Below is a list of the extra features you receive with the SYSOP version of GIF-REED: The SYSOP version allows you to create a series of catalogs, from image files within a subdirectory, by using a single DOS command. This automates the process of cataloging GIF/BMP/PCX/PIC files. In this mode NO KEYBOARD OR USER INTERACTION IS REQUIRED. This is different from the other versions of GIF-REED in that the OTHER versions require you to get into the program and press menu selections in order to do a catalog process. This of course is NOT an automated way of doing things. The SYSOP version supports the insertion of titles into picture catalogs being created by GIF-REED. (See the section on Catalogs). The Sysop version also supports the DIR files created & used by PCBOARD 14.5 & Up. It also supports the creating of a TEXT file used by the WildCat program WCFILE to import descriptions into the WildCat directory listings. Please read the section on SYSOP GIF-REED for complete details. Any question or comments please call me at 1-800-25-FLASH and ask for Davie Lee Reed. All technical questions should be called to 1- 317-253-8088. **************************************************************** __________________________________________________________________________ GIF-REED 7 __________________________________________________________________________ ********** Licensed OEM version of GIF-REED ********** We also offer an OEM version of GIF-REED. This version has all of the features of the SHAREWARE version. Below is a description of the OEM version of GIF-REED: The OEM version of GIF-REED is a version that CD-ROM manufacturers can license for use on their CD-ROM discs. This OEM version will NOT have the SHAREWARE logon screens that require you to type certain words before the program starts. This makes it easier for the end-user to use the program. The OEM version also allows GIF-REED to fully utilize the catalogs created by GIF-REED, without having to use the DOS ASSIGN command or to be forced to create multiple directories of the SAME catalog images. In other words, the catalog images will automatically KNOW to look on the CD-ROM for the images to load and display! This is DIFFERENT from the SHAREWARE version of GIF-REED. The SHAREWARE version of GIF-REED looks to the original SUBDIRECTORY PATH for loading the image you choose at the catalog screen. So, if you created the catalog pictures based on images found in C:\GIFS\CARS, the NON-OEM versions of GIF-REED would look to your C: drive for loading the picture you selected off the catalog. If you transfer the catalog images to a CD-ROM and distribute the CD- ROM to users, when they select to view an image from the catalog, GIF-REED would look to the C: drive for the pictures to view. This of course would be incorrect since the CD-ROM drive would more than likely be a drive letter other than C:. Since GIF-REED would NOT be able to find the picture on YOUR C: drive, GIF-REED would display an error indicating that it couldn't find the picture file. There are two ways to work around this. (1) Create multiple catalog directories in which the source path in the catalog files have different drive letters for the source images. (2) You can use the ASSIGN command to make your C: drive look like the CD-ROM drive. The only problem with this is that once you exit GIF-REED, you can't UNDO the assign command and you would have to RE-BOOT the system. With the OEM version this problem wouldn't occur! This special OEM version can be used after a special licensing agreement has been signed by Software Matters and yourself. If you have any questions or comments please call me at 1-800-25- FLASH and ask for Davie Lee Reed. All technical questions should be called to 1-317-253-8088. **************************************************************** __________________________________________________________________________ 8 GIF-REED __________________________________________________________________________ GIF-REED Version Comparisons Below is a simple table of features to let you know which version of GIF-REED will best suit your needs. +--------------------------------------------------------------+ | Feature | NON-REG | REG | PRO | SYSOP | |--------------------------------------------------------------| | Price SHAREWARE $25 $49.95 $89.95| | Use XMS for picture buffer X X X | | Save Configuration Settings X X X | | Mirror Image X X X | | Flip Image X X X | | Image Editing X X | | Draw & Fill Boxes & Lines X X | | Rotate Image X X X | | Maximum Image Width 2048 2048 8192 8192 | | Maximum Screen Width 1024 1024 2048 2048 | | Maximum Rows in Catalogs 3 4 10 10 | | Catalog output file up to 640x480 X X X X | | Catalog output file up to 800x600 X X X | | Catalog output file up to 2048x1536 X X | | Automatic Catalog generation & Titles X | | Catalog Support for BBS Dir files X | | Print Any Size onto paper X X X | | DOS/BOSS Key X X X | | Number of files in file list 256 512 1500 4000 | | Directories To View At Once 6 6 20 20 | | Print restricted to 4 inches X | | Print images up to 8x10 inches X X X | | Print images Centered or with margins X X | | Simple script commands only X X | | Enhanced script language commands X X | +--------------------------------------------------------------+ NOTE: Prices subject to change without notice. __________________________________________________________________________ GIF-REED 9 __________________________________________________________________________ GIF-REED Update Policy After ordering GIF-REED there will of course be improvements made to the program over time. These improvements will be offered to you at a reduced price. These are called updates. Below is the update price structure for all versions of GIF-REED: +---------------------------------------------------------+ | Version Of GIF-REED | List Price | Update Price | |---------------------------------------------------------| | | | | | SHAREWARE | NO CHARGE | NO CHARGE | | REGISTERED | $25 | $12 | | PRO | $49.95 | $17 | | SYSOP | $89.95 | $30 | | | | | +---------------------------------------------------------+ NOTE: Prices subject to change without notice. If you decide that you need a more advanced version of the software than you currently paid for, you can UPGRADE your version to any level of GIF-REED. The amount to pay would be the difference between the list price of the version you currently own and the one you want to UPGRADE to PLUS $10. This way most of the money you already spent can be applied to the newer version you desire. So for example: If you already own PRO GIF-REED you can UPGRADE to the SYSOP version for $89.95 minus $49.95 plus $10.00 which comes out to $50.00 This of course is cheaper that ordering the SYSOP version straight out! As always, please include $5.00 for shipping/handling for orders in the USA and Canada. ALL other countries being shipped to, please add $9.00 NOTE: Please don't look at this as a way of milking users. After all, you DON'T have to UPDATE or UPGRADE ever. We just offer our latest and greatest changes to you so you have the ability to acquire the newer better software. It's up to you if you think it's worth it or not! Also by supporting our update system, we will continue to improve the software so that you can have the most flexibility and enjoyment from your picture files. Otherwise if nobody updates, we of course would probably stop any further improvements to the program. NOTE: Also, you are encouraged to earn MONEY from our product by following the directions in the MONEY.DOC file. __________________________________________________________________________ 10 GIF-REED __________________________________________________________________________ Purpose GIF-REED is designed to be a picture viewer for GIF, BMP, PIC and PCX files. In addition to being a viewer, GIF-REED can also create GIF, BMP, PIC and PCX files. In other words you can manipulate a picture and then save it out as a BMP, GIF, PIC or PCX file. This is great for trimming (cropping) stuff from a picture that you don't want in the picture anymore. Of course slide shows, cataloging and picture printing are main aspects of the program too. Mouse users will find that the mouse support offered in GIF- REED is excellent. You can use the mouse to select files from the files menu. You can also use the mouse to trim parts of the picture away while you are viewing the picture. Now that you understand why GIF-REED was written and what the main purpose of the program is, you should continue reading to fully understand how to use all of the capabilities of the program. Before we show you HOW to use the program, let us LIST all of the features found in GIF-REED. Along with each feature, the action to invoke the feature is listed. GIF REED Program Features GIF-REED has many features. The features are broken down into categories for easier understanding. Below is a list of the categories and their respective features. File Formats Supported * GIF89a aware and supports ALL of the GIF89a specifications features that the 89a standard offers in a GIF file including comments, multiple images & transparencies. * Support Windows BMP files of 2/16/256 colors. Also 24 BIT color is supported! Compressed BMP files are NOT supported. In fact pictures that are NOT simple drawings are usually BIGGER when stored as compressed BMP files. * Support GIF files of 2/16/256 colors. Interlaced GIF files are supported. GIF files with a MAC (Apple) header are also supported! * Supports PC-Paint/Pictor Paint PIC files of 2/16/256 colors! You can also write out 2/16/256 color PIC files. * Supports ZSoft PCX files of 2/16/256 and 24BIT color! You can also write out 2/16/256 color PCX files. Standard Features __________________________________________________________________________ GIF-REED 11 __________________________________________________________________________ * Only requires 384K of memory to run (and will view any size picture!). * Pictures of up to 1024 x 768 in up to 256 colors can be displayed and manipulated. PRO GIF-REED supports higher resolutions if your VGA card can support it. * Images up to 2048 dots wide are supported. PRO GIF-REED supports up to 8192 dots wide. * VGA and EGA are both supported. * CD-ROM support * Squeezing more DOS RAM from your system (F8 at the main menu) * Loads & Displays Pictures (GIF/BMP/PCX/PIC) as fast or FASTER than other viewers. * You can choose between viewing the picture as it loads or waiting until the picture is read in before displaying it. (Press F2 at the main menu.) * The resolution of the screen is automatically determined. * You can override this AUTO mode so that the resolution you pick is LOCKED on. This way no matter what size picture is loaded, the resolution you picked will be used to display the picture. (Press F5-F6 and F7 at the main menu/or while viewing.) * You can select if you want GIF comments to be displayed for GIF files that have comments in them. (Press ALT-F10 to change this option.) * You can center the picture or place it on the upper left. (Press C or O while viewing.) * You can enlarge/shrink the picture to fit the screen. (Press TAB or SHIFT-TAB while viewing.) * You can change the resolution while viewing with the +- keys. * You can WRITE out the graphics screen to a .GIF, .BMP, .PIC or PCX file. (Press W while viewing.) * Savable configuration options. Such as current settings and currently selected paths! (Press ALT-U at main menu) __________________________________________________________________________ 12 GIF-REED __________________________________________________________________________ * ALT-U Allows you to save your video configuration. This is so that the program will load quicker! Beware that if you do then if you change VIDEO HARDWARE, you must RE-DO your video setup! You CAN'T OVERRIDE your default VIDEO configuration by using the "GIFREED=xxxxx" environment variable. If your video setup is incorrect, then simply select option 6 from the ALT-U menu. If you can't get this far into the program, because of the incorrect video selection, just delete the configuration file called GIFV.CFG! You can press option 8 to save your PRINTER's configuration out to a file called GIFV.PRN. * Automatic Video configuration. Special Features * Complete script file language, including a script file viewer and editor. * DOS/BOSS key. Pressing ALT-F2 at, almost, ANYTIME causes the screen to clear and a shell copy of DOS to come up. After typing EXIT to get out of the DOS Shell, your system will appear to be locked up. Now Press ALT- F2 again and your screen will re-appear (even graphics screens). (Press ALT-F2 at any time, even while viewing!) * BBS support for the SYSOP version of GIF-REED * Personal Scoring System (or category system!). You can assign a number from 1-9 to a file. Then you can sort by SCORES. You can also do a slide show of a particular SCORE! This feature also allows you to give each GIF file a COMMENT description and a list of keywords that associate with the file! You can then do a slide show for pictures that MATCH certain keywords. You can also do a slide show by CATEGORY. (Press ALT-Y at main menu to assign SCORE (category)) * ALT-P gives you New Report features. You can generate reports by 1. FILENAME resolution, size, score, keywords 2. FILENAME resolution, category, comments * Mouse control while at file selection menu. Left button loads picture to screen. Right button tags (selects) file. Middle button is like pressing ESCAPE, even while viewing a picture! * Deletion of any resolution mode. (Press F9 at main menu) __________________________________________________________________________ GIF-REED 13 __________________________________________________________________________ * You can mark a BOX on the screen, with the mouse, to be BLOWN up in one of two different methods. The BOX can also be used to trim the picture. * You can print what is on your screen to an HP laser printer or EPSON dot matrix printer. (Press P while viewing.) * You can use the arrow keys or the mouse to move the picture around on your screen. * Pressing PgDn/PgUp or Left/Right mouse buttons, while viewing, takes you to the next picture. * You can use the mouse to pick files from the files list. * You can load & display a picture and exit with the picture still on the screen. (See loading options.) * PuzzleFUN is built in. Take any picture and turn it into a game! (ALT-E while viewing picture) * Allows for CATALOGing of your image files. You can create catalogs of your images and you can then pick images to display from the catalog file. This gives you a graphical menu system for your pictures. (COOL!) (CTRL-C at the main menu) * Operations that CHANGE the picture such as Enlarging or Shrinking will automatically save a copy of the original to a TEMP area. This is so that you may restore the picture back if the operation didn't achieve what you wanted. Unlimited levels of UNDO are supported, unless of course you run out of TEMP space. * Press "R" while viewing a picture and the last operation on the picture to CHANGE the picture will be UN-DONE. You can press "R" as many times as you wish to keep UN-DOING what you've done! If you've done MANY operations on the picture and you just want to get back to the ORIGINAL picture, just press ALT-R (While viewing of course). * You can turn off this UNDO feature to speed up operations on the picture. (Press F4 at the main menu.) * You can select either EMS memory, XMS Memory, or DISK space for the TEMP picture buffer area. Since disk space isn't terribly fast you should use the ENVIRONMENT variable TEMP to re-direct the TEMP disk space to the __________________________________________________________________________ 14 GIF-REED __________________________________________________________________________ fastest drive you have, preferably a RAMDISK. See the section on TEMP Areas and the Picture Buffer. (Press F3 at the main menu.) Slide Show Features * You can TAG (mark) files for viewing for a slide show effect. (Press SPACE BAR or RIGHT mouse button to tag/untag files at the main menu.) * You can have a slide show that fades out the current picture before showing the next picture. (Press F10 at the main menu.) * You can have a slide show that has a venetian blind effect for loading the pictures! (Press F10 at the main menu.) * You can have a slide show that has an expanding effect for loading the pictures! (Press F10 at the main menu.) * You can have a slide show that has a merging effect for loading the pictures! (Press F10 at the main menu.) * You can specify a time for each slide to stay on the screen. (Press F10 to change the time.) * You can choose between an endless slide show that keeps looping back to the start when finished, or to just run through the slides once. (Pressing F10 switches between endless & one pass.) * While in slide show mode, you may press the SPACE BAR and you will be stopped at that picture. You can then move it around or whatever you wish. When you want to start the slide show again, press the PgDn key. Picture Editing Features * You can add text to your images! (Press ALT-T while viewing) * You can add BOXES and LINES to your images! (Press B after marking a box) * You can mark a BOX and fill it in with any color you select. __________________________________________________________________________ GIF-REED 15 __________________________________________________________________________ (Press DEL after marking a box) * You can change the order of your color map while in the pixel editing mode. (Press E while viewing) * You can change a color in the entire image to another color in the color map. (Press C while pixel editing) * You can sort the image's color-map by frequency of use in the image. (Press S while viewing) * You can make the images Windows compatible by getting RID of the TOP 16 colors (of the 256) in the color map. Then save the image back out! (Press A while viewing) * You can EDIT your images with the pixel editor! You can change the DOT colors and the color map easily! (Press E while viewing) * You can add comments or keep old comments in your GIF files that you save out. (See W command while viewing image) * You can change the RED/GREEN/BLUE intensities. (Press CTRL-F1 through CTRL-F6 while viewing.) * You can change the CONTRAST/BRIGHTNESS of pictures too. (Press CTRL-F8 through CTRL-F10 while viewing.) * You can RESTORE the colors after you have played with the above color modification functions. (Press ALT-F10 while viewing.) * You can force the picture to a GRAY scale picture. This looks like a black & white photograph. (Press G while viewing.) * You can invert (reverse) the colors so that a negative effect is displayed. (Press I while viewing.) * Palette Animate. This changes the colors of the screen in a sequential method that makes the picture look like it's alive! (Press ALT-F9 while viewing) * You can flip the picture sideways for a Mirror image effect. (Press M while viewing.) __________________________________________________________________________ 16 GIF-REED __________________________________________________________________________ * You can flip the picture upside down for an upside down effect. (Press F while viewing.) * You can rotate the picture clockwise for a sideways view. (Press > while viewing.) File Management Features * You can delete tagged files. (Press ALT-D to delete tagged files.) * You can rename tagged files. (Press ALT-R to rename tagged files.) * You can MOVE tagged files. (Press ALT-M to MOVE tagged files.) * You can COPY tagged files. (Press ALT-C to COPY tagged files.) * You can have the files list sorted by many different choices. (Press ALT-S to change the sort mode.) * You can change what path(s) are to be searched for loading pictures. (Press ALT-F to change the File paths.) * You can search drives for GIF, BMP, PIC and PCX files. (Press ALT-G at the main menu.) * You can delete a file as you are viewing it. (Press ALT-D while in view mode.) __________________________________________________________________________ GIF-REED 17 __________________________________________________________________________ Getting Started If the GIF-REED package you have is in a ZIPped format, you must first UN-ZIP it in its own directory. For example: C>CD\ C>MD GIFV C>PKUNZIP GIFV501 C:\GIFV This procedure will create a subdirectory on drive C: called GIFV. It then unzips the GIFVxx.ZIP file into the newly created directory. Once the files are unzipped, you may then use the program. NOTE: It doesn't matter what name you give the subdirectory to hold the GIF-REED files. To run GIF-REED, type the following: C>GIFV This runs the GIF-REED program. If you are running GIF-REED for the first time, you may need to configure it for your particular video card. If GIF-REED can't automatically detect what kind of video card you have, you are given the opportunity to tell GIF-REED to try to figure out what kind of video card you have. If your video card is supported by GIF-REED, a list of one or more video cards to select from is displayed. Make sure the one you pick has the most amount of resolutions supported and has the (FAST) indicator by it. The (FAST) indicator tells you this setting will be very fast (hardware direct). Otherwise if you select one that has the (SLOW) indicator, GIF-REED will use BIOS functions to perform all screen writing. This method is VERY SLOW! If you are NOT shown a list to pick from, you are truly out of luck. At this point you have three options to choose from. 1. You can call us at 1-800-25-FLASH and ask us to support your video card. 2. You can try loading a VESA driver that is designed for your video card. In fact a VESA driver may have come on a disk with your SVGA board. 3. Continue to run GIF-REED, but with only 320x200 VGA support. This is the VGA standard. NOTE: If it appears that your system locks up, please call 1-800- 25-FLASH and let us know what kind of video card you have and we will work to get GIF-REED to work for you! When you load GIF-REED, you may hear a BEEP. This beep indicates that you have NOT YET setup up your video configuration. This is just a reminder. You don't have to setup it up, but the program loads faster if you do. Also, upon loading you will see the Software Matters Inc. logo! __________________________________________________________________________ 18 GIF-REED __________________________________________________________________________ NOTE: If you want to disable the use of your VESA driver by GIF- REED you can use the following statement in your AUTOEXEC.BAT or at the DOS Prompt: C>SET GIFREED=NOVESA You can force GIFREED to use a specific hardware setup by using the GIFREED environment variable. For example: C>SET GIFREED=TS4000 This will make GIF-REED think it is operating on a system with a TS4000 VGA board. __________________________________________________________________________ GIF-REED 19 __________________________________________________________________________ Other Ways Of Loading GIF-REED NOTE: You should read the section on Path Lists to fully understand what happens when you select a directory to display pictures from. GIF-REED can also be loaded by typing the following: C>GIFV C:\GIFS\CARS C:\GIFS\BIRDS This loads GIF-REED and indicates that TWO subdirectories should be loaded at the same time (using ALL files that are supported by GIF- REED). In fact you can specify up to 20 directories on the command line. If NO directories are specified, the default directory will be loaded (using .GIF, .BMP, .PIC and .PCX files). If you were to type: C>GIFV C:\GIFS\CARS C:\GIFS\BIRDS\*.* The *.* indicates to override the default of the NORMAL image file format extensions of .GIF, .BMP, .PCX and .PIC. Every file in the directory will be looked at to see if it is a GIF, BMP, PIC or PCX file. Even if the picture has NO extension GIF-REED is smart enough to determine which files are GIF, BMP, PIC and PCX. This can be used as a SECRET (Wife, Girlfriend) mode. This way you can rename all of your GIF files to *. which indicates NO extension. Then when you load GIF-REED use the *. or *.* parameter. This will then show you all of your picture files. You can also specify *.? to indicate ALL picture formats that GIF- REED supports. For example: C>GIFV C:\IMAGES\*.? This would load all GIF, BMP, PCX and PIC files using just one file path specification. This is the BEST way to load a directory since it searches automatically for ALL image formats that GIF-REED supports. You can change which directories are displayed within the program using the ALT-F key at the file menu. If you type the following: C>GIFV the current directory is searched for GIF, BMP, PIC and PCX files, unless you had SAVED your directory paths by using the ALT-U function. If you saved your paths, then those directories saved would be the ones searched upon loading GIF-REED. This makes it easy to run GIF-REED and still have a slew of directories pre- loaded into your file list menu without having to type in the directory names each time you load the program. __________________________________________________________________________ 20 GIF-REED __________________________________________________________________________ Loading Image Onto Screen Then Exit You can also tell GIF-REED to load a picture and exit with the picture still on the screen. You could load a picture file to your screen in your AUTOEXEC.BAT file. Then have the rest of your AUTOEXEC.BAT file commands follow the picture loading statement. This way you get a nice looking screen quickly and while the AUTOEXEC.BAT is taking its time doing things you are looking at a pretty screen. For example: C>GIFV /L1:0:F:\DSF333.GIF This tells GIF-REED to load the file "F:\DSF333.GIF" and then display it and then EXIT. The "1" tells GIF-REED to use resolution mode "1". ALL VGA adapters use 320x200 as resolution mode 1. The file list menu shows ALL of the resolution modes you can pick from. Not all SVGA cards have the SAME resolutions available, so the number of resolutions to pick from and their actual resolution may differ from one another. The "0" indicates NO delay. If you use "*" for the delay time, it will keep the image on the screen UNTIL you press a key. You can use numbers from 0 through 9 for the delay time as well as the "*". For example: C>GIFV /L1:*:F:\DSF333.GIF This keeps the image on the screen until you press a keystroke. If you specify a resolution mode of "0" then GIF-REED will pick the best mode suitable for the image being displayed! For example: C>GIFV /L0:9:F:\DSF333.GIF This loads the image on the screen with the BEST resolution mode selected. It will then wait 9 seconds and the exit. If you hear a BEEP when using the /L option, it's probably because you picked a resolution number too high and GIF-REED is telling you it's defaulting to the highest resolution number available. __________________________________________________________________________ GIF-REED 21 __________________________________________________________________________ Using The Script Language You can tell GIF-REED to execute a script file by using the /P:x command. The "x" denotes which of the possible 26 script files you wish to execute (run). "x" can be any letter from "A" through "Z". See the section Script Language Overview for more details on how script files work. See the section on Script File Viewer / Editor for more information on how to create / modify script files. Before using the /P:x command, look at the script file with a text editor or word processor before running it. Make sure it doesn't do things you don't want such as deleting files you might want to keep. The sample script files are named GIFV.SLA through GIFV.SLZ, where GIFV.SLS is the script file "S". For example: C>GIFV /P:S This executes the GIFV.SLS script file. C>GIFV /P:B F:\CAT\*.GIF D:\CAT\*.BMP This executes the GIFV.SLB script file. It also passes along two parameters. If the script file is set up to operate on a user supplied directory, then the two directories that are passed can be used by the script file's "CHANGE-PATH" command. This way the script files can be very flexible. You can set up a batch file to go through many subdirectories on your hard drive without having to set up multiple script files! NOTE: Since the script files that come with GIF-REED are samples, you should ALWAYS view them before running them to make sure it's going to do what you want. In fact some of them that reference drive letters G: and F: may not run at all. However there are a few that don't make a specific drive & path reference. These are: gifv.slM Slide show gifv.slN Better slide show gifv.slO Change display resolution gifv.slP Print pictures to printer gifv.slQ Prints file statistics gifv.slU Prints report on picture files. If you press CTRL-S at the main file list menu, you will be placed into the script editor. Here you can view any of the script files. You could even edit them and then later execute (run) them. __________________________________________________________________________ 22 GIF-REED __________________________________________________________________________ System Requirements Video Hardware Requirements You need to have at least EGA capability. VGA capability is highly recommended since the image quality is DRASTICALLY reduced by EGA viewing modes. System MEMORY Requirements The NON-REGISTERED version requires a minimum of 390K of DOS RAM to run. And a maximum of 456K needed for FULL capacity. The REGISTERED version requires a minimum of 334K of DOS RAM to run. And a maximum of 400K needed for FULL capacity. The PRO GIF-REED version requires a minimum of 390K of DOS RAM to run. And a maximum of 614K needed for FULL capacity. The SYSOP GIF-REED version requires a minimum of 390K of DOS RAM to run. And a maximum of 614K needed for FULL capacity. See the section on "Getting More DOS RAM From GIF-REED" in order to get by with less DOS RAM. You should, but don't have to, have at least 1 meg of EMS or XMS memory for the picture buffer that's used by GIF-REED. You can also use disk space if no EMS or XMS memory is present. Disk space is MUCH MUCH MUCH slower than EMS or XMS memory. If you plan to use DISK space for the picture buffer, you might want to cache you hard drive. (See the section that describes the PICTURE BUFFER) NOTE: EMS memory support is for EMS memory that supports version 4.0 EMS specification or higher. EMS 3.2 specification is NOT supported by this program! Other Hardware Options A mouse is optional for most functions in the program which makes the program a lot easier to use. In fact if you want to do editing of pictures you MUST have a mouse installed. A printer is needed only if you plan on printing reports of pictures! Currently, if you want to print a picture you must have an HP LASER or EPSON compatible printer! __________________________________________________________________________ GIF-REED 23 __________________________________________________________________________ Misc. System Considerations GIF-REED has a feature that saves picture information everytime you make a change to it like TRIM/SHRINK/ENLARGE. If you have the RESTORE (See F4 function key description) option set ON/TRUE then you could possibly run out of disk space if you did a lot of TRIMming. The disk space is used so that you can undo your changes. Make sure that you have set the environment variable TEMP or TMP to point to a drive that is FAST and has at least 2 MEGS of free disk space available on it. When GIF-REED exits, the temporary files created by it are deleted. This way GIF-REED won't EAT up your disk space. You should have a statement in your CONFIG.SYS file that says FILES=20 or higher. For example, a good CONFIG.SYS could look like this: BUFFERS=20 FILES=20 DOS=HIGH DEVICE=HIMEM.SYS An example of a bad CONFIG.SYS could look like this: FILES=10 BUFFERS=40 DEVICE=HIMEM.SYS NOTE: You can use EDLIN or just about any word processor to change your CONFIG.SYS. The CONFIG.SYS file is located in C:\ in about 99% of ALL machines. __________________________________________________________________________ 24 GIF-REED __________________________________________________________________________ Getting MORE DOS RAM From GIF-REED GIF-REED allows you to utilize EMS/XMS or DISK space to get more DOS RAM so that certain functions that require a LOT of DOS RAM can work even though you may have a lot of files loaded in the file list. Each file takes up about 50 bytes of memory. 20 files would then take up about 1K. Thus 2000 files would take up about 100K of DOS RAM. This file list can be stored into EMS/XMS or DISK space to save the use of DOS RAM. (See the Main File List Menu Operation Section [Function F8]) __________________________________________________________________________ GIF-REED 25 __________________________________________________________________________ CD-ROM Support By GIF-REED GIF-REED fully supports the CD-ROM by accessing the CD-ROM as a READ/ONLY drive. This means that you will NOT be able to delete files from the CD-ROM drive. When you license GIF-REED to be used on a CD-ROM that you manufacture & sell, GIF-REED KNOWS it's a CD- ROM and automatically changes the TEMP path to DRIVE C:, UNLESS the user has already set up the TEMP environment variable to point somewhere that is writable. GIF-REED's catalog capability has the ability to know that the catalog is being read from a CD-ROM drive and will automatically know where to look for the source image files! (See the Cataloging section of this manual) __________________________________________________________________________ 26 GIF-REED __________________________________________________________________________ Files Needed/Used/Created By GIF-REED Files Needed By GIF-REED Documentation Files READ.ME Read me file (Read this first) GIFREED.DOC Manual for GIF-REED ORDER.FRM Order form for GIF-REED OFFER.DOC Special program offers from Software Matters MONEY.DOC Shows how you can earn MONEY from GIF-REED! DESC.BBS Description file for GIF-REED for uploading the NON-REGISTERED version of GIF-REED to other BBSs. Please do NOT give the REGISTERED version of GIF-REED to anybody! Programs To Run GIFV.EXE GIF-REED Program GIFV.GIF Initial screen for GIF-REED GIFV1.HLP Help file for GIF-REED's function keys GIFV2.HLP Help file for GIF-REED's Script Language GIFVWIN.EXE Customize GIF-REED for Windows 3.x GIFV.ICO Window's ICON for GIF-REED GIFV.PIF Window's PIF file for GIF-REED MAKEROM.EXE Program to produce a copy of your video ROM PRINTDOC.BAT Prints manual (GIFREED.DOC) to your printer Sample Script Files GIFV.SLA-SLW Used by the script language interpreter Sample GIF Files GIFVTIT.GIF Sample TITLE file for Cataloging feature MYCAT_01.GIF Sample catalog file produced by GIF-REED 640x480 Black & White image. MYCAT_02.GIF Sample catalog file produced by GIF-REED 320x200 Color image PUZZLE1.GIF GIF file for use with puzzle feature PUZZLE2.GIF GIF file for use with puzzle feature PUZZLE3.GIF GIF file for use with puzzle feature PUZZLE4.GIF GIF file for use with puzzle feature PUZZLE5.GIF GIF file for use with puzzle feature SAMPLE.GIF Sample GIF file created by GIF-REED's Text capabilities and pixel editing features! SUZIE1.GIF Sample photograph scanned in by us! These files are contained in the distribution set for GIF-REED. If these files are NOT ALL contained in the distribution set you received, call us at 1-800-25-FLASH to receive your full set. All technical questions should be called to 1-317-253-8088. Files Created & Used By GIF-REED __________________________________________________________________________ GIF-REED 27 __________________________________________________________________________ GIFV.CFG Configuration file GIFV.DIR Default directories to load GIFV.GRD Scores, categories, keywords and comments GIFV.DAT Used by GIF-REED GIFV.CAT Used to hold CATALOGing options GIFV.PRN Used to hold PRINTing configuration options These files are created along the way after you start using GIF- REED. They keep track of what kind of default settings you wish to use. The .GRD file is special in that it's like a database. It keeps track of all comments, scores, categories and keywords for your picture files. Temporary Files Created By GIF-REED $$$$$$$$.$$$ Used to check TEMP space available GIFVTEMP.$$$ Used with the WRITE script command GIFV.$$$ Used for GIF89a files GIFV.1-999 Used for the UNDO feature GIFV.TMP Used to NON-Interlace GIF file GIFV.CMT Used for displaying comments GIFV.PAL Used by cataloging process GIFV.DTH Used by cataloging process GIFVC###.CAT Used by cataloging process GIFV.TIT Used by cataloging process If you see any of the above temporary files left around AFTER you have exited GIF-REED you may delete them. They are NOT needed when GIF-REED loads. Files Created By YOU GIFV.SLx Text files used for the personalized slide show. These are called script files. "x" is between "A" and "Z". This means you can have up to 26 different slide show script files. NOTE: These files MUST reside in the SAME directory as the other GIF-REED files. GIFVINIT.PRN Codes sent to the printer BEFORE an image is printed to the paper. GIFVPOST.PRN Codes sent to the printer AFTER an image is printed to the paper. __________________________________________________________________________ 28 GIF-REED __________________________________________________________________________ TEMP Areas & Picture Buffer There are many references to TEMP area and TEMP Drive and Picture buffer. In fact on the main file list menu screen you can see that F3 allows you to change the area to EMS, DISK or XMS. This selection indicates where you want the picture buffer to be stored. In other words when a picture is loaded, it isn't just loaded into the video cards memory. It's also loaded into (EMS/DISK or XMS) memory as well. This way you can scroll (PAN) around the picture and do neat things like MIRROR image and ROTATE etc... The choice of EMS/DISK/XMS should be in order of speed: 1. EMS 2. XMS 3. DISK Space If you don't have EMS or XMS memory available, go ahead and use DISK space for the picture buffer. This is the slowest of them all but what the heck at least the program will function. It is wisest to set the environment variable TEMP or TMP to point to a RAM DISK. If you don't have a RAM DISK now, set one up. See your DOS Manual on how to set one up. Make sure the RAM DISK is at least 1 or 2 Megs in size (the larger the better). This is because other things are stored there as well (such as the undo save area). Let's say that you have a RAM DISK as drive G: Just put the following statement in your AUTOEXEC.BAT file: SET TEMP=G:\ This tells GIF-REED to store it's DISK picture buffer into the RAM DISK (if the TEMP area was set to DISK). It also tells GIF-REED to do all of it's temporary disk accesses on the RAM DISK. Everytime you alter a picture and the RESTORE option is turned on, a copy of the picture is made onto the RAM DISK. These TEMP files also use the "TEMP" environment variable to see where to place the TEMP files. NOTE: The picture buffer area is ALSO used in conjunction with the DOS RAM memory saving feature. If you choose to use this feature, the picture buffer area will be used to store certain information about each file in the files list. See the section on "Main File List Menu Operation, Function F8". NOTE: Even though you specify EMS or XMS memory to store the picture buffer, the TEMP files created by GIF-REED will STILL go to the TEMP Drive indicated by the "TEMP" environment variable. NOTE: GIF-REED will also look at the "TMP" environment variable as well as the "TEMP". __________________________________________________________________________ GIF-REED 29 __________________________________________________________________________ What is a Color Map (Palette) A color map is what's used in picture files to create the image. Imagine a picture of the U.S. flag. This picture would require only 3 colors. RED, WHITE and BLUE of course. You would assign each color a number. For example: Red would be 1, White would be 2 and Blue would be 3. The file on the disk would contain a bunch of numbers in it. For example, if a picture was 10 dots wide and 5 dots tall, the sequence of numbers might be: 1 1 1 1 1 2 2 2 2 2 1 1 1 1 1 2 2 2 2 2 1 1 1 1 1 2 2 2 2 2 3333333333333333333 3333333333333333333 This image when loaded would look like a Red box to the left of a White box. It would also have a thick Blue line on the bottom. This picture file would also contain information as to what the 1, 2 and 3 should translate into (colorwise). This extra information is called a color palette. In this manual we refer to it as a color map or color table. Most high quality pictures have 256 color entries in the color map. Some have slightly less but most are at 256. If your image uses the TOP 16 entries in the list (241-256) then it WON'T be Windows compatible. This is because Windows reuses the last 16 entries in the color map to look like other colors the Windows system needs. This means if a picture was viewed in Windows, the picture would have parts of the image with the WRONG colors in it. It all depends on the frequency of usage of the colors that Windows grabs away. If your picture only used color #256 only once in the picture then when Windows views it, the picture may look ok. In order to GUARANTEE Windows compatibility, the image must NOT use ANY of the top 16 colors in the color map (241 through 256). GIF-REED is setup to automatically take an image and adjust the image so that the top 16 colors are NOT needed or used by the picture anymore. We take the top 16 colors and remap them to the closest color match available in the lower part of the color map (1 through 240). This way your picture stays looking good. You can do this adjustment while viewing the image by pressing "A" while viewing the picture. Of course you would have to save the picture back out to disk before attempting to have Windows display it. You can also do this through our script language system with the ADJUST-FOR-WINDOWS command. Again you would have to WRITE the file back out. __________________________________________________________________________ 30 GIF-REED __________________________________________________________________________ Keyboard Mouse Simulator We have a built in MOUSE simulator if you don't have a mouse hooked into your system. You can use this FAKE mouse by using your keyboard. In order to tell your keyboard that you are doing FAKE mouse activity, you must have the SCROLL-LOCK light ON. You can now perform all of the functions of a two button mouse. Below is a list of the mouse functions supported and what keys need to be pressed to achieve them: Mouse Function Keyboard Action Left Mouse Button: Press Left Shift Key Right Mouse Button: Press Right Shift Key Move Mouse Right: Press GRAY Right Arrow Move Mouse Left: Press GRAY Left Arrow Move Mouse Up: Press GRAY Up Arrow Move Mouse Down: Press GRAY Down Arrow NOTE: To turn off the keyboard mouse simulator, just turn OFF the SCROLL-LOCK light. While the keyboard is in mouse simulation mode, you will hear a buzz coming from the speaker to let you know what mode the keyboard is in. NOTE: The Arrow keys used above for the mouse actions MUST MUST MUST be the ones that are GRAY sitting in between the numeric keypad and the rest of the keyboard. NOTE: When using the SHIFT-ARROW keys to actually MOVE the picture around (a NON Mouse function), you MUST MUST MUST use the arrows on the NUMERIC KEYPAD! NOTE: The keyboard mouse simulator has built in accelerators so that it won't take you too long to get the mouse cursor across the screen. The accelerator is activated by holding the arrow key down. The longer you hold it down the faster the mouse moves. __________________________________________________________________________ GIF-REED 31 __________________________________________________________________________ Keyboard Input Considerations Line Input Editing There are many places in the program in which you are allowed to type in a line of information. For example: If you press ALT-F at the main file list menu, you can type in up to 20 directory paths. When typing in a line of input you can use the Home, End, Left, Right keys for ease of editing. You can use the Insert and Delete keys as well. In addition, you can use the backspace key for deleting backwards. If you want to delete the entire line, just press CTRL-Y. NOTE: It might also be noted that pressing ALT-F2 at just about any place in the program causes the DOS/BOSS function to be invoked. __________________________________________________________________________ 32 GIF-REED __________________________________________________________________________ Path Lists (What good are they?) GIF-REED has the ability to display files from more than one directory. In fact it can show up to 6 different path selections and the PRO GIF-REED can show up to 20 input directory paths. See ALT-F below in the Main File List Menu Operation section. When you load GIF-REED you can specify multiple directories. For example: C>GIFV C:\GIFS C:\PICTURES\*.BMP This example specifies two paths. The first path will load all of the image files from the path called C:\GIFS. The second path will load all of the .BMP files from the directory called C:\PICTURES. NOTE: You can use a special indicator of *.? to load all images that GIF-REED supports. In otherwords you can say: C>GIFV F:\PICTURES\*.? This loads all of the files that are of a format that GIF-REED supports. Currently GIF, BMP, PCX and PIC are the supported formats. NOTE: If you do not specify a wildcard such as *.BMP or *.PCX etc... then GIF-REED assumes that you want *.? The first path specified is used to display subdirectory names along with the files that are in that directory. The subdirectory names appear in []. For example: The files menu list might contain the following: [ .. ] [ NICE ] [ CHARTS ] 1 PRETTY GIF 1 GIRL GIF 2 BRICKS BMP 2 CARS BMP 2 LOGO BMP The files PRETTY.GIF and GIRL.GIF have a one (1) next to them to indicate that they were retrieved from the 1st path in the path list. The files BRICKS.BMP, CARS.BMP and LOGO.BMP have a two (2) next to them to indicate that they were loaded from the 2nd path in the path list. The names "..", "NICE" and "CHARTS" were obtained from the 1st path in the path list. In otherwords they are all subdirectories underneath the path of C:\GIFS which is the 1st entry in the path list. NOTE: Subdirectory names do NOT have a number to the left of them. Instead they are indicated by []. If you were to select CHARTS then the file list could look like the following: [ .. ] __________________________________________________________________________ GIF-REED 33 __________________________________________________________________________ 1 CHART1 GIF 1 CHART2 GIF 1 GRAPH1 BMP 1 GRAPH2 BMP 1 GAME COM 2 BRICKS BMP 2 CARS BMP 2 LOGO BMP As you can see, the file list changes to reflect the fact that you are now displaying the directory of CHARTS that was underneath the path of C:\GIFS. So the directory displayed is C:\GIFS\CHARTS\*.*. Since selecting a subdirectory forces the wildcard file specification to *.?. You will also notice that the BRICKS.BMP, CARS.BMP and LOGO.BMP are still displayed too. This is because you still have two (2) paths in the path list for displaying. NOTE: If the subdirectory is [ .. ], then it is an indicator that when selected you will be placed into the previous directory (that is the parent of the current directory). So by selecting [ .. ] you will be right back where you started. NOTE: You will also see a list of available drive letters to choose from. Just point and shoot, it's that easy! HINT: If you want GIF-REED to remember a list of frequently used paths, you can enter the paths into the path list with the ALT-F key. Then you can save this list out with the ALT-U key. Then the next time GIF-REED loads, your popular paths will be loaded into the path list. If you just want to display one (1) path at a time but still be able to switch between your popular paths (without having to type in the path names), we suggest that you enter your paths with a ";" in front of the path name. For example: ;C:\GIF ;C:\BMPS\*.BMP Since the ";" makes the path specification invalid, no files will load from these paths in the path list. If you want to display C:\BMPS\*.BMP, then press ALT-F and remove the ";" from the name and poof, that directory will load and display. Although this may seem clever, we made no program changes to account for this. We let DOS do all of the work in deciding if a valid directory was specified or not. You can change the path list by pressing ALT-F at the main file list menu. If you change the path list and want to get back to the original path list that you started with, press CTRL-L at the main file list menu. __________________________________________________________________________ 34 GIF-REED __________________________________________________________________________ Main File List Screen Layout The main file list menu is easy to understand. It is broken into 4 parts. (1) File list Area (2) Status Area (3) Misc Info Area (4) Bottom Line Area File List Menu Area The file list area consists of multiple columns of filenames. Next to each filename is a number from (0-9). This number represents which directory in the list of directories that that file belongs to. It can also contain subdirectory names from which you can switch to. These optional subdirectory entries are obtained from the 1st path in the path lists. (See Path Lists) Status Area The status area shows the current settings of the GIF-REED program. This area is on the bottom part of the screen. It shows what VGA/EGA modes are available and which one is selected to be locked if resolution locking is true (See F7). To the left of the modes you will see "VGA:" or "EGA:". This indicates what mode the pictures will be viewed in. Misc Info Area The Misc area is in the middle of the screen. It shows what resolution is highlighted. It shows the current file width, height, number of colors then score. It also shows the file size and the directory path from where it came from. Between the file size and path is a special indicator. This indicator will contain a "[ ]" or "[I]" or "[C]". The "I" indicates that the currently selected file is a GIF Interlaced file. The "C" indicates that the currently selected file is a BMP Compressed file. You can optionally choose to have the DATE and CATEGORY of a file displayed instead of the file SIZE and PATH. Just use the ALT-L command from the main menu. This area also shows the total number of files in the file list. It shows the total number of files tagged. It also shows the total size of all tagged files added together. Bottom Line Area __________________________________________________________________________ GIF-REED 35 __________________________________________________________________________ The very bottom line on the screen has a "MENU" activator. If you click on this with the mouse, you will get a pop-up menu from which to choose items. On the right hand side on the bottom line, you will see things such as "GO: L:FADE :4" or "GO: L:NONE :2". This is the status of your slide show controls. There are 4 sections. 1. The word "GO" can be clicked on to start the slide show with the files that have been tagged/selected. This is simpler than going through the F10 menu. 2. The " L" or "NL" indicates if the slide show is in looping or NON-looping status. 3. NONE means a normal slide show. (No special effects). Fade means you are in fade in/out mode. Blind means you are in venetian blind mode. Xpand means you are in expanding slide show mode. Merge means you are in merging slide show mode. Zebra means you are in Zebra slide show mode. RANDM means you are in RANDOM slide show effects mode. 4. The last item is the number of seconds of delay between slides. Just click on it and it will increment to the next higher value until a maximum of 9 seconds is reached at which point it will flip back to 0 (zero) second delay. __________________________________________________________________________ 36 GIF-REED __________________________________________________________________________ Main File List Menu Operation Once you have loaded GIF-REED, you should see a list of files displayed on the screen. If NO files appear in the list, you should press ALT-F to select a directory that has GIFs, BMPs, PICs or PCX files in it. Now that you have a list of files to choose from, the fun begins. At this point you have a lot of options. F1 brings up a help screen that shows you what the various function keys do. F2 changes how a picture is loaded. Normally a picture is displayed as it's being loaded. The F2 key can switch this so that the picture is NOT displayed until it is completely loaded. This makes for a different (quicker) effect. Choose a setting that you most desire. F3 allows you to change the picture buffer area. You can pick between EMS Expanded memory, XMS memory or DISK space. EMS memory is faster than XMS memory and XMS memory is faster than using DISK space. Some systems don't have Expanded memory, in this case use XMS memory. Some systems don't have either EMS or XMS memory. In this case use DISK space. To get a clearer idea of the speed differences, below is a benchmark of various screen related functions that make frequent and common access to the picture buffer: EMS Memory 2.6 Seconds XMS Memory 3.0 Seconds RAM DISK 3.17 Seconds HARD DRIVE 3.17 Seconds (Caching with FLASH) HARD DRIVE 15.5 Seconds (NO Disk Caching, Normal) This should give you a clearer idea of just how much faster the different types of memory are, compared to a standard hard drive. If you do have Expanded memory, make sure you have enough. We suggest that you have at least 1024K of Expanded memory available at the time you run GIF-REED. If you don't have Expanded memory or don't want to create any, then use XMS memory of the same amount (about 1024K should be enough). If you don't have any XMS memory, use DISK space. Now, it may not be obvious, but a RAM DISK is much faster than a floppy or a hard drive. If you do select DISK space, direct the DISK space area to a RAM DISK. This will make the video operations go much faster. Of course __________________________________________________________________________ GIF-REED 37 __________________________________________________________________________ you have to know how to make a RAM DISK and you have to have about 1024K (1MEG) of RAM to spare to create this RAM DISK. If you can create the RAM DISK, direct the TEMP DISK space area to it like so: C>SET TEMP=G:\ or C>SET TMP=G:\ This example assumes that your RAM DISK was drive G: Of course you would substitute in your RAM DISK drive letter here. The SET statement is a DOS command that can be done at the DOS prompt or even from within the AUTOEXEC.BAT file. If you don't have Expanded memory and don't have XMS memory and don't have the luxury of creating a RAM DISK, use a disk cache. This will speed things up quite a bit. In fact, if the disk cache has delayed writes, background writes or lazy writes, then use that option as well. This makes GIF-REED go even faster. If you don't have a disk cache or your disk cache doesn't support delayed writes, call us at 1-800-25-FLASH and we will sell you our disk cache called FLASH at a reduced price. FLASH won PC Magazines Editor's Choice award. It is a top notch disk cache. F4 allows you to specify if you want UNDO capability. Let's say that you load a picture and then crop it so that only a portion of the original picture is now displayed. At this point you can RESTORE the picture by pressing the R key. Any operation that ALTERS the actual picture image can be restored by pressing the R key. In fact you can alter the image multiple times and then restore the image multiple times. You are only limited by disk space. By selecting NO restore capability, operations that alter the image are done faster because the image doesn't have to be saved out first. F5 increases the locking resolution. Every time you press the F5 key you will notice that the resolution highlighted moves to the right (better resolutions). Doing this alone doesn't accomplish anything, but when used together with F7 and F9 you can do some nifty things. F6 decreases the locking resolution. Every time you press the F6 key you will notice that the resolution highlighted moves to the left towards a lower resolution. As with F5, F6 doesn't do anything useful except move the highlighted resolution. __________________________________________________________________________ 38 GIF-REED __________________________________________________________________________ F7 locks/unlocks the resolution highlighted. You can actually lock in on a resolution. For example: You could lock in on a resolution of 1024x768 by pressing the F6 key a few times, then press the F7 key. Once locked, every picture loaded from then on will be displayed in the 1024x768 mode, even if the picture is a much smaller picture. You can of course unlock the resolution by pressing the F7 key again. F8 This option allows you to get more DOS RAM available for GIF-REED. Every 500 files in the files list consumes about 25K of DOS RAM. This DOS RAM can be saved by storing the files list into the picture buffer area. By doing so you can have MORE DOS RAM available to GIF-REED while viewing the image so that you may ROTATE/TRIM and do other functions. It may even make the difference between being able to load the image or NOT! You can also use the picture buffer area to store the file list when doing Cataloging functions. Again by doing so, it can make the difference between being able to do a Catalog or NOT! Of course this storing (saving) feature takes time. NOT much, but still it takes time. If you are using EMS memory for the picture buffer, you will NOT notice ANY time loss. If you use XMS memory you will notice just a fraction of a second loss in time before an image appears on the screen. If you use DISK space for the picture buffer you will wait about 1 second before the picture loads. If you use a disk cache, such as FLASH from us, this 1 second can be reduced to about 1/3 of a second. F8 allows you to turn on this saving feature. You specify if you want this feature turned on during viewing a file, during a slide show or during the cataloging process. Since turning the feature on can slow (slightly) the loading of an image, you don't want to have it turned on if you don't need to. If you find that certain operations of GIF-REED say that you need more DOS RAM, then turn this feature on. Once you decide that you want this feature turned on, you should decide at what point you want it turned on. In other words, how big should the files list be before saving the file list in the picture buffer. Since 100 files would result in only 5K of DOS RAM savings, you might consider setting the limit to 1000. This means that once the files list goes over 1000 files then the saving feature will be turned on. This would result in about 50K of DOS RAM savings. You can of course set this to a smaller or larger number depending on your needs. NOTE: If your version of GIF-REED is registered, you can save your settings out to a configuration file __________________________________________________________________________ GIF-REED 39 __________________________________________________________________________ (GIFV.CFG). This way you don't have to keep setting this option each time you load GIF-REED. F9 Resolution deletion. After you have highlighted the proper resolution with the F5 and F6 keys, you can press the F9 key to delete that resolution from the list. You might wonder why you would want to do this. Well let's say that you have a cheap monitor hooked up to a good video card. It is quite possible that a mode of 800x600 might not work on your monitor, but that the other modes of 320x200, 640x480 and 1024x768 work just fine with your monitor. By deleting a resolution that your monitor can't handle, you eliminate the possibility of using that mode which doesn't work. One way to test all of the modes with your monitor is to lock in on every mode and view the same picture. If a mode produces squished lines or quickly scrolling lines, then it's a safe bet that that mode isn't supported by your monitor and thus should be deleted from the supported list. You can think of this feature as a way to make GIF-REED work with POOR equipment. Please beware that you would have to do this everytime you loaded GIF-REED unless you save your video setup with the ALT-U key. NOTE: In EGA mode the resolution deletion does NOT function. We know of NO monitors that WON'T work in all of the EGA modes that we support, therefore it is unneeded! F10 F10 Starts a slide show and can change some of the attributes of a slide show. Once you press F10, you can press return to do a slide show of all selected files. You select files by pressing the SPACE BAR when the file is highlighted. After pressing F10, you can also change the time delay between pictures. You can also specify whether the slide show should be continuously looping or just shown one time. You can select from many different slide show special effects. You can choose NO special effects, or you can select from any of the following special effects: Fading Venetian Blinds Expanding Merging The above options are mutually exclusive. That means that only one of them may be selected at a time. In other words you can NOT have a slide show that FADES and EXPANDS at the SAME time. __________________________________________________________________________ 40 GIF-REED __________________________________________________________________________ You can also specify to do a slide show of a selected category, score, or even by keywords that you may have associated with files. (See ALT-Y) NOTE: If you select to slide show by score, category or keyword, your file list will be tagged to show what the slide show used. NOTE: See the section on Slide Show Features/Operations. ALT-C copies all tagged files to a new destination. If no files are tagged, then the file highlighted will be copied. ALT-D deletes all tagged files. If no files are tagged, then the file highlighted will be deleted. ALT-F allows you to change what directories are displayed in the file list. You can enter up to 20 directories. You can use the normal editing keys. A special CTRL-Y editing key is used to delete an entire line. An example directory could be: C:\GIFSTUFF\CARS\*.GIF or C:\WIN31\*.BMP These are both valid directories for GIF-REED to try to read and display. When finished editing the file directory list, press return to load up the new list. Otherwise press ESCAPE to abort any changes made. If you find yourself constantly typing in the SAME directories everytime you load the program, you might consider saving out the directory paths configuration. You can do this with ALT-U. ALT-G searches all of your drives and adds to the directory list all of the directories that contain GIF, BMP, PIC or PCX files. ALT-I inverts the tagged file list. This function may seem useless but in fact is very powerful. Let's say that you have a list of 40 files. Let's also say that you want to copy all but 2 files. Instead of tagging 38 files, just tag the 2 files you DON'T want to copy, then press ALT-I to reverse (invert) the tagged list and then poof, all the files you want tagged are tagged and the ones you don't want tagged are NOT tagged. ALT-L toggles the INFO BAR line to show file size and path or file date and category. You can also click the mouse on the line to toggle it. ALT-M moves files to a new directory. If no files are tagged, then the highlighted file will be moved. __________________________________________________________________________ GIF-REED 41 __________________________________________________________________________ ALT-P Report generation. Pressing ALT-P allows you to print two different types of reports. (1) You can list all of your files along with any comments, scores, keywords or categories that you may have assigned. GIF-REED allows you to assign scores, categories and keywords to picture files. Press ALT-Y to assign information such as a score to a file. ALT-P allows you to print a list of your files along with the associated information. If a printer error occurs while printing, an error message will appear and the printing will abort. NOTE: You can indicate that ALL printer output is to go to a disk file of your choice! NOTE: In order to produce a report, you may notice that the program says "Please wait while reading file Info". This is because certain information about each file needs to be read in before the report can start. Once the information is read in, you can report without waiting. This information only needs to be read in ONCE!. As an extra added feature, this information is read in while you are doing other things in the program. Therefore you may never get this message, unless you load a huge file list and request a report right away. ALT-R renames files. If no files are tagged, then the highlighted file will be renamed. ALT-S allows you to pick a new sort criteria. You can sort by name, size, date/time, resolution, score, path, category and number of colors in the image. If you sort by path you will notice that all of the files in a directory are grouped together. Next to each filename is a number from 1 to 20. This is the directory number that corresponds to the 20 directories that can be loaded. NOTE: The sorting sequence chosen is displayed at the end of the tagged INFO BAR line. NOTE: In order to sort on anything OTHER than Name, Date, Size or Path you may notice that the program says "Please wait while reading file Info". This is because certain information about each file needs to be read in before the sort can start. Once the information is read in, you can sort by any criteria. This information only needs to be read in ONCE! As an extra added feature, this information is read in while you are doing other things in the program. So you may never get this message, unless you load a huge file list and request sorting right away. You can tell how far GIF-REED has gotten by noting the "[Scanning:####]" message that is displayed on the tagged INFO BAR line. The #### is the file number that is currently being read for certain information. __________________________________________________________________________ 42 GIF-REED __________________________________________________________________________ ALT-T clears the tagged list. ALT-U allows you to save your user configuration. Shown below are the different configuration files that are used and what's contained in them: GIFV.CFG Display while loading or after loading EMS, XMS or DISK space for the Picture Buffer RESTORE picture status GIF comments display status Resolution to lock in on if locking status=true Resolution locking status SlideShow looping status SlideShow delay time File Sort Type Video resolutions available Hardware Direct or BIOS mode flag SlideShow type Video hardware setup More DOS RAM options GIFV.DIR Path Lists (Up to 20) GIFV.PRN Printer options GIFV.CAT Cataloging options You can also UNDO your video setup and UNDO your directory paths. If you save your directory paths, the next time GIF-REED is loaded, the saved paths will be loaded again. This saves you time from having to type in all of the directory paths that you want loaded. After saving your video configuration, you will NOT need the environment variable GIFREED if you were previously using it. In fact, it will be IGNORED! If you change your video card you might want to undo the video setup then exit GIF-REED and then re-do the video setup configuration. If this doesn't work, delete GIFV.CFG and then re-do the video setup. ALT-Y allows you to assign information to a file. You can give a highlighted file a Score (0-9), category, description and keywords. ALT-F2 is the DOS/BOSS key. If the BOSS walks in, you can press the ALT-F2 key and you will be placed at a DOS prompt. Thus making it appear that you are doing work, NOT PLAY. When the BOSS leaves, type EXIT to get out of the DOS __________________________________________________________________________ GIF-REED 43 __________________________________________________________________________ shell. Then press ALT-F2 to get back into the GIF-REED program. NOTE: If you are NOT at a text screen or in the main graphic viewing part of the program, when you come back from the DOS prompt the screen may not be restored to what you think it should be. Just press a few keystrokes and the screen will come back! NOTE: This DOS prompt is an actual DOS prompt. You can do any DOS command that the normal DOS prompt can do. The only limitation you will have is that LESS DOS memory is available. Thus you may NOT be able to load large programs. But everything else should work just fine. ALT-F7 Allows you to toggle between EGA and VGA modes. If your system only supports EGA then you won't be able to toggle to VGA modes. The EGA and VGA modes can each have their own resolution to lock into if resolution locking is true.(See F7). ALT-F10 Allows you to toggle on/off the displaying of GIF comments. If a GIF file has comments built into it GIF- REED will display the comments to you AFTER you have viewed the picture. If you toggle this option off, then the comments will NOT be shown to you. CTRL-C brings up the CATALOG options menu. From here you can select what size of catalog (640x480, 800x600, etc..) and how many rows of pictures to be placed in the catalog. You can even select whether or not you want the catalogs produced to have a custom created graphics TITLE placed at the TOP or BOTTOM on the catalogs. See the section on Catalog Features/Operations. NOTE: Once you have selected the options you desire, it's a good idea to use the ALT-U function to SAVE your catalog options. This way you won't have to keep selecting your favorite options each time you load GIF- REED. CTRL-L reloads the path list. If you change your path list with the ALT-F command and then decide you want to restore the path list to the way it was when you first loaded GIF- REED, press CTRL-L at the main file list menu. This operation re-reads the GIFV.DIR file. CTRL-S This brings up the script language Viewer/Editor. The script language command definitions and reasons why you would want to use a script file are described in the section "Script Language Overview". Once you are in the Script Viewer/Editor mode, you can view any script file by pressing any letter from "A" __________________________________________________________________________ 44 GIF-REED __________________________________________________________________________ through "Z". This gives you 26 different script files that can be created, edited, viewed or executed. The actual script file on disk is called "GIFV.SLx" where "x" is the letter "A" through "Z". You can easily edit the script file by pressing ALT-E to get into edit mode. Script File Viewer While you are in the viewing mode, you can do many functions. These are the things that you may do while VIEWING the script file: F1 Brings up help screen about viewing CTRL-F1 Context sensitive help F9 Checks for invalid commands (syntax check) F10 Executes the script file you are viewing ALT-L Print (List) Script file to printer ESCAPE Exit script viewer/editor Once you have selected a letter for the script file, you will be shown the file in the script viewer. This is so you may verify that the script file you selected is the one you want to run. You can use the arrow keys and PgUp and PgDn keys to move around the file. If you decide the letter you picked was incorrect, press a letter from "A" through "Z" then the script file in the viewer changes to the new one you just selected. If you decide you picked the right one, press F10 to execute the script file. If you decide you don't want to run the script press ESCAPE. NOTE: Pressing F9 performs a simple syntax check. It checks to make sure each line contains either a comment line (starting with a semi-colon ";"), or a valid command or a blank line. If the command can't be found, it is flagged as an error. If it is a valid command that has a :LABEL to jump to, then a check is made to insure the :LABEL exists somewhere in the script file. If not, the line is flagged as an error. If the command is one that requires a number such as "BEEP 9", it is checked to make sure a valid number is present. If not, it is flagged as an error. NOTE: If you press F10 to run a script file, a syntax check is performed. If there are any errors encountered in the script file, the script file is NOT executed. This is to prevent you from running an invalid script file. In fact you are placed on the script line in error. Script File Editor __________________________________________________________________________ GIF-REED 45 __________________________________________________________________________ Once you are in the viewing mode you can press ALT-E to enter the edit mode for the script file. The editor has many of the SAME control keys that are used by popular editors such as Word Star, Turbo Pascal, Quick Basic and the DOS EDITOR that comes with DOS 5.0 and up. They are as follows: CTRL-G Delete Character CTRL-Y Delete Line CTRL-R Page Up CTRL-C Page Dn CTRL-S Left one character CTRL-D Right one character CTRL-E Up one line CTRL-X Dn one line This is so that you may feel more at home while using the script editor. There are other commands that you may use while in the edit mode. They are as follows: F1 Brings up help screen about viewing CTRL-F1 Context sensitive help F2 Saves script file changes F3 Start block marking F4 Stop block marking F9 Checks for invalid commands (syntax check) ALT-C CUT a marked block ALT-P Paste a block ALT-I Insert Line ALT-D Delete line ALT-L Print (List) Script file to printer ESCAPE Go back to viewing mode In edit mode, you can press ALT-C and ALT-P to perform cut and paste operations. In order to mark a block for CUTting, press F3 when the cursor is on the line you want to start the block. Then move the cursor to the last line you want marked. Then press ALT-C to CUT. If you decide you don't want to mark any blocks, press F4 to abort block marking. Also, in the edit mode, you can press ALT- I and ALT-D to insert or delete lines. If you position the cursor on a line with a script command in it and press CTRL-F1 the context sensitive help is displayed about the command in question. Once you are done editing, press ESCAPE. You will be brought back to the viewing mode. NOTE: See the section on Script Language Overview. SPACE BAR tags a file for slide show, copy, move, delete or rename operations. See ALT-C, ALT-M, ALT-D, ALT-R and F10. ESCAPE exits the program. __________________________________________________________________________ 46 GIF-REED __________________________________________________________________________ ENTER loads a picture onto the screen. After the picture is loaded you can do many things with it. If there is an error in loading the picture, an error message will be displayed on the screen. NOTE: If you press ENTER on a subdirectory then you will be switched into that directory. The 1st file path of the 6-20 file paths available will change to reflect the NEW directory that you chose. You can see this for yourself by pressing ALT-F after changing to a different subdirectory. The subdirectories are indicated by a name inside of "[]". For example "[ GIFS ]" would indicate that you could switch to a directory called "GIFS". NOTE: If you are currently in a subdirectory, then you will see [..UP a DIR] as a choice. This is a special subdirectory name. It indicates that you want to go back up one directory (to the parent directory). NOTE: If you have specified more that one (1) file path then each time you press return to load up a different subdirectory, you will STILL see the files from the 2nd, 3rd and so on paths in ADDITION to the files in the new path you have just chosen. NOTE: It should also be noted that all of the available drives in your system will be displayed as the first entries in the file list. This way you can switch to a different drive easily. Just point and shoot. __________________________________________________________________________ GIF-REED 47 __________________________________________________________________________ Mouse Operation At File List The mouse can be used in the file list menu easily. Just move the mouse cursor to a file and press the left button and poof, the picture is loaded. If you were to press the right button, the file would become tagged. If you were to press the middle button, you would EXIT the program. Now let's say that you have more files than would fit on a screen. In order for the mouse to indicate that you would like the files to scroll to the left or right, you would simply place the mouse in the left or right margins of the screen and Click! If the filename that you click on happens to be a subdirectory name then you will be switched into that directory. Subdirectory names are enclosed in "[]". For example: "[ GIFS ]". If the name you click on happens to be a drive letter then you will be switched into that drive! You can click on the INFO BAR line that shows the files resolution and size and path. This toggles between showing file size and file date. You can also click on the "VGA:" or "EGA:" title that is to the left of the available resolution modes. By clicking on EGA: you change it to VGA:. If it said "VGA:" then it will change to "EGA:". It's like a toggle switch.(See ALT-F7) You can also click on the function keys at the bottom of the screen on the status area. You can also click on the bottom line where it shows "MENU", and a menu of operations will pop-up. You can then click on the operation that you want to do, or you can press ESC or click the middle button to abort. If you click on the bottom line where the slide show controls are displayed, you can change these options with the mouse without having to use the keyboard driven menus to change the options. Just place the mouse on the option to change and then click on it. NOTE: When the program asks for (Y)es or (N)o input, you can click the Left and Right buttons to simulate the keyboard responses! Also the middle button acts like the ESCAPE key in this case. __________________________________________________________________________ 48 GIF-REED __________________________________________________________________________ Viewing Options Once you are viewing a picture, you can do many things. There are many keys and function keys that perform various operations. The following is a list of all keystroke operations categorized: Color/Brightness Controls SHIFT-F1/F2 increases or decreases the amount of RED intensity of the picture. This adds/subtracts RED evenly across the entire image. SHIFT-F3/F4 increases or decreases the amount of GREEN intensity of the picture. This adds/subtracts GREEN evenly across the entire image. SHIFT-F5/F6 increases or decreases the amount of BLUE intensity of the picture. This adds/subtracts BLUE evenly across the entire image. CTRL-F1/F2 increases or decreases the amount of RED intensity of the picture. This makes red areas more red and leaves areas that aren't red alone. CTRL-F3/F4 increases or decreases the amount of GREEN intensity of the picture. This makes green areas more green and leaves areas that aren't green alone. CTRL-F5/F6 increases or decreases the amount of BLUE intensity of the picture. This makes blue areas more blue and leaves areas that aren't blue alone. CTRL-F7/F8 increases or decreases the contrast of the picture. CTRL-F9/F10 increases or decreases the brightness of the picture. I inverts (reverses) the colors. It makes pictures look as though they are a negative. G force the picture into a GRAY picture. ALT-F9 animates the color palette. In other words all of the colors in the picture change rapidly. It almost makes the picture look like it's moving. It's great for fractal images. Fractal images are computer generated images that look like scenery. ALT-F10 restores the coloring of the picture after you have played with the color changing operations above. __________________________________________________________________________ GIF-REED 49 __________________________________________________________________________ Picture Movement C centers the picture on the screen. O Orients the picture into the upper left hand corner of your screen. Arrow Keys move the picture around the screen up, down, left and right in case you can't view the entire pictures on your screen at once. If you hold down on the SHIFT key while using the numeric keypad arrow keys, the picture will move in larger increments. This allows you to move faster to a specific spot in the picture. General Program Operations F1 brings up the help screens. ALT-F2 is the DOS/BOSS key. It shells you out to a DOS prompt. At this point you can do any DOS commands and even run small programs. Once finished with the DOS Shell, type EXIT at the DOS prompt and you will be asked to enter a password. Press ALT-F2 at this time. You will then be placed back into the picture on your screen. ESC quits out of view mode and places you back at the file list menu. PgUp/PgDn allows you to view the Previous/Next picture in the file list without having to go back to the file list menu. File Operations P prints the screen to your printer. See the section on Printing Operations. ALT-D will delete the picture you are looking at. W writes the current screen to a GIF, BMP, PIC or PCX file of your choice. If you write a file, upon returning to the main file list menu, ALL files will be re-read from the disk to build the file list menu. This is so that the NEW file you just created will appear in the list. NOTE: If you had any selected files in the list of files, you will be given the opportunity to NOT reload the list. This preserves your selections! __________________________________________________________________________ 50 GIF-REED __________________________________________________________________________ NOTE: GIF and BMP files save in the 256 color mode. The PCX and PIC file format allows you to select 2/16/256 colors before writing out the new PCX or PIC file. NOTE: When creating a GIF file you can add comments to your GIF file. If you choose to add comments the GIF file will be written out as a GIF89a file instead of a GIF87a file. This means that some OLDER viewers may not be able to read it. If your screen is in 320x200 mode your comments can only be 35 characters wide, otherwise you can type up to 75 characters per line of comment. When done adding comments just press RETURN when the comment line is prompted. ALT-F displays information about the picture file, such as filename, size, resolution, score and category and number of colors in the image. ALT-C allows you to copy all of the marked (selected) images from the catalog file you are currently displaying. You are then asked to enter the destination path. You can press ESCAPE at this point or enter a valid path or press RETURN to accept the default path. If any file(s) couldn't be copied (disk full), an error message will be displayed. These files will NOT become un-marked after the copy operation is completed. This is so you may put in a new floppy and press ALT-C again to copy the remaining files that didn't copy in the first place. See the section on Catalog Features/Operations. Image Control ALT-E Entertainment mode. After you press ALT-E, you will be asked if you want to play an easy, hard or expert game. The game is actually a puzzle. PuzzleFun actually takes the image and shakes it up so that its scattered about. It's up to you to put it back together. It can also be used as an educational tool for children! For complete details on PuzzleFun, see the chapter on Puzzle-Fun. E edits the picture. You can edit the picture's colors. You can even change the look of specified colors (you could change bright red to appear as a dark red). You can also change the order of the colors in the color map! Pixel Editor Screen Layout The edit screen is broken into 4 parts. __________________________________________________________________________ GIF-REED 51 __________________________________________________________________________ 1. Color Map 2. Pixel Editing Window 3. Viewing Window 4. Color Adjusting Window The Color Map is displayed on the top half of the screen. You can select colors from this color map to change individual DOTS (pixels) in the image. The color map shows 256 colors. Some images don't use all 256 color entries. If a color entry is NOT used by the image, it is displayed with a white dot surrounded by a black box surrounded by the color. The Pixel Editing Window is in the lower right portion of the screen. This window is an enlargement of 26 DOTS wide and 26 DOTS high. These DOTS can have their colors changed easily! The Viewing Window shows a reduced portion of the entire image. You can move around the image by using this viewing window and your mouse. This window is in the lower left portion of the screen. The viewing window is bordered by the default foreground color. This border is bordered by the default background color. This is so that you can see the foreground and background colors at a glance. The Color Adjusting Window allows you to make a GLOBAL change to ANY color in the image. In other words you can make the color RED become BLUE throughout the ENTIRE picture. The Color Adjusting Window is located in the same spot as the Viewing Window. Color Map Functions In order to pick a color, you must move the mouse over the color in the color map that you want to select and then press the LEFT or RIGHT button depending if you want to change the default of the foreground or background colors. If you move the mouse into the color map and press DEL, the color under the mouse will be deleted. You can then move the mouse to the point where you want to insert it back into the color map. Simply press INSert and poof the color map will move to adjust. Also, ALL colors used in the picture will be updated so that your image doesn't get distorted (wrong) colors being displayed. __________________________________________________________________________ 52 GIF-REED __________________________________________________________________________ If you press "C" while the mouse is on top of a color in the color map, you can convert a color in the image into a NEW color. After pressing "C" while the mouse is on top of the color you want to convert, move the mouse to the NEW color in the color map and click the mouse button. This will take every part of the picture that had the OLD color in it and replace it with the NEW color specified by the click of the mouse. This is great for translating colors. Once you have performed this operation, the OLD color in the color map is now UNUSED! If you choose, you can use it for what you like! The image is then displayed for you to see if you like it. Press any key to quit the preview display. It will then ask if you want to save the changes. Respond properly. Edit Screen Functions If you click the left button on one of the colors in the color map, then the default foreground color changes to this color. If you click the right button on one of the colors in the color map, then the default background color changes to this color. If you place the mouse cursor into the pixel editing window (lower right portion of the screen), clicking the left button changes the current color to the default foreground color. Clicking the right button changes the current DOT (pixel) to the default background color. If you hold the button down and move the mouse around, you will be changing a lot of dots until you lift off the mouse button. If you press "F" or "B" while the mouse is in the pixel editing window, the FOREground/BACKground colors will change to the color the mouse is sitting on top of in the pixel editing window. If you press "U" while in the Pixel Editing Window you can undo the last change you made. In fact it remembers the last 600 DOT changes you made to the picture. Everytime you pan (move) the picture and accept/abort the changes, the UN-DO buffer gets reset to zero. If you press "V" you can view the entire image on the screen. This is so that you can see what the changes you have made have done to the picture. Pressing any key gets you back to editing. Viewing Window Movement __________________________________________________________________________ GIF-REED 53 __________________________________________________________________________ If you press on any mouse button while the mouse cursor is NOT in the color map or pixel editing window, the picture will move (pan) in the direction you move the mouse until you lift up off the mouse button. If you have changed ANY dots in the pixel editing window, you will be asked if you want to save the changes before panning. Color Adjusting Function If you press the SPACE-BAR while the mouse is in the color map OR in the pixel editing window, the color that the mouse is sitting on will be Graphed out in the lower left hand portion of the screen into the Color Adjusting Window. This graph is broken into 3 parts. The Top bar shows how much RED is in the color, the Middle bar shows how much GREEN and the Bottom bar shows how much BLUE is in the color. If you place the mouse over one of the 3 bars you can increase or decrease the amount of RED, GREEN or BLUE that makes up the color that you chose. Press ESCAPE if you don't like the changes, otherwise press RETURN. If you press "V" you can see the entire image to see just how the color change that you made effects the picture. Pressing any key resumes color adjusting! This feature allows you to make GLOBAL changes to a color. Everywhere the color that you are changing exists in the image also gets changed! This is great for changing the background colors etc... When Done When finished making changes press ESCAPE. NOTE: You can press F1 for help while editing DOTS. You can also press F1 for additional help while in the Color Adjusting Window. F flips the picture top to bottom. Think of this as an upside down function. M mirror images the picture. Think of this as a sideways operation. > rotates the picture clockwise. S This allows you to sort the image's color-map. It sorts the color map with the most frequently used colors at the front of the color map. This is great for images being displayed in Windows, because __________________________________________________________________________ 54 GIF-REED __________________________________________________________________________ Windows GRABS the TOP 16 colors (if you're using a 256 color driver for Windows) in every image's color map for display purposes. This produces FUNNY looking pictures if the picture used a lot of a particular color that Windows took over and changed to its own liking! By sorting the color map, the least used colors are placed at the top. In fact a lot of images don't use the full 256 colors available in the color map. This means that most images wouldn't be disturbed by Windows (after sorting is done) because the colors used by Windows would be colors in the color map that weren't even used by the image! If you edit the picture using the "E" command, the colors in the color map that aren't used by the picture are displayed with a white dot surrounded by a black box surrounded by the color. Here is a cheap looking example of a color in the color map. CCCCCCCCCCCC CCCCCCCCCCCC CCCCCBBBCCCC CCCCCBWBCCCC CCCCCBBBCCCC CCCCCCCCCCCC CCCCCCCCCCCC The "C" represents the ACTUAL color of the color in the Color Map. The "B" represents BLACK color. And the "W" represents WHITE color. Once you have sorted the colors, you should update the image colors. The program asks if you wish this to happen. If you don't do this, the image will look rather strange, however it might be interesting to do on fractal images or images other than photographic type images. A Pressing "A" while viewing a picture allows you to ADJUST the colors in the picture for use within Windows. The TOP 16 colors are removed from the picture's Color Map, while trying to keep the parts of the image that used those removed colors using colors that closely matched what were in the original image! This way, if you SAVE the picture back to disk and use it in Windows, the picture will be displayed by Windows without disturbing ANY of the colors in the image. R restores the picture back from an image altering function such as a trim or resize. __________________________________________________________________________ GIF-REED 55 __________________________________________________________________________ ALT-R restores the picture back to its original look. It's like pressing "R" many times or pressing ESC to get back to the main file list menu then pressing return to reload the picture. As you can see, this saves keystrokes. But more important than saving ONE keystroke, it's FASTER! ALT-T adds text to the picture. You can select between 3 different text styles. You can choose between 5 different text sizes. You can also select the foreground and background colors of the text. You can choose between straight text or transparent text. Once you have chosen the text features you want, the actual text is placed in the upper left hand corner of your screen. You can place the text anywhere on the screen by using the mouse. When placed where you want it, just click any mouse button. NOTE: If you want the text to be upside down or sideways, just rotate the picture first and then add the text! Pretty clever? TAB resizes the picture to fit the screen if the picture needs to be enlarged or shrunk to fit within the current screen size. The method of enlarging or shrinking is a standard method and is quite fast. SHIFT-TAB resizes the picture to fit the screen if the picture needs to be enlarged or shrunk to fit within the current screen size. The method of enlarging or shrinking is special to GIF-REED and produces a better image than the standard method, however it is slower. This option shouldn't be used on line drawings. It works better with scanned photographs. + increases the screen resolution. The images will appear to get smaller as you increase the resolution. - decreases the screen resolution. The images will appear to get larger as you decrease the resolution. F7 locks/unlocks the resolution to whatever screen resolution you happen to be in. This way the next picture that gets loaded will be loaded in that resolution too. __________________________________________________________________________ 56 GIF-REED __________________________________________________________________________ Mouse Operation While Viewing After a picture is loaded, you will NOT see the mouse cursor. This is so that the picture in its entirety is displayed without an annoying mouse cursor smack in the middle of the screen. Once you MOVE the mouse around, the mouse cursor will appear. NOTE: When the program asks for (Y)es or (N)o input, you can click the Left and Right buttons to simulate the keyboard responses! Also the middle button acts like the ESCAPE key in this case. You can click the Middle mouse button and it will act as though you pressed ESC to get you back to the main file list menu. If you QUICK-click the right button it will act as though you pressed the PgDn key to load the next picture. If you QUICK-click the left button it will act as though you pressed the PgUp key to load the previous picture. NOTE: If you are in a catalog image file, you must make sure the mouse is NOT pointing to an image in the catalog for the PgUp and PgDn functions to work. If you hold down on the left button and then move it around you will see the picture move around too. This is called picture panning. If you hold down on the right mouse button, you will be able to draw a box by moving the mouse around. You can see the width and height of the box displayed in the upper left hand corner of your screen. If you let go of the right button, the screen will refresh and act as though you did nothing useful. This is handy if you decide to draw a box in a different spot. If you move the mouse all the way to the edge of the screen, the picture will move over (pan) so that you have an opportunity to make a bigger box. This is great if you want to mark a box that is BIGGER than what your screen is. Once you have the box the way you want it, hold down on the left button. This freezes the box on the screen. Now you have 5 choices: (1) TRIM/CROP you can click on the outside of the box and the picture will be trimmed so that everything outside the box is erased. (2) ENLARGE 1 you can click the right button while the mouse cursor is INSIDE the box and the image inside the box will be enlarged to fill the screen using the enlarging mode-1. (3) ENLARGE 2 you can click the left button while the mouse is inside the box to enlarge the image using enlarging mode-2. Enlarging mode-1 is the standard way. It's fast and pretty good. Enlarging mode-2 is our special way. It's __________________________________________________________________________ GIF-REED 57 __________________________________________________________________________ slower, but creates much better results, especially in the higher resolution modes. (4) ERASE BOX You can press the DELete key and the entire box will be filled in with a color of your choice. You can either select the default BackGround color or you can choose a color from the color map. This allows you to make cool looking boxes and borders. It's possible to increase the image dimensions by having part of the box OUTSIDE of the current image dimensions. If this occurs, the image is automatically enlarged in order to allow the BOX you drew to be added to the picture. (5) BOX/LINE You can press "B" to indicate that you want to make a box. You will be asked what color you want to make the box and also how thick to make the box. NOTE: If you want this BOX making procedure to make a BOX very narrow you can see that you can actually create LINES as well! It's possible to increase the image dimensions by having part of the box OUTSIDE of the current image dimensions. If this occurs the image is automatically enlarged in order to allow the BOX you drew to be added to the picture. __________________________________________________________________________ 58 GIF-REED __________________________________________________________________________ Printing Operations GIF-REED has a powerful print feature that prints to an HP or EPSON compatible type printer. GIF-REED supports 8 pin and 24 pin operation of the EPSON Dot Matrix printers. If you own an EPSON RX, MX or FX then only 8 pin operation will take place. If you own an EPSON LQ series printer then 24 pin or 8 pin operations can be chosen. There are many options that control the printed output. These options are broken into groups. Print Quality The print quality options control how the printed output will look. There are 4 options in this part. 1. Halftone-A 2. Halftone-B 3. Dithered Only 4. Smoothing Halftone-A produces excellent output for images that are multicolored. Color images look great when printed using the halftone-A option. Black & White or just two color images don't look as good using this method. Halftone-B is the same as halftone-A except that the output looks a little better in most cases. Play to see which gives you better looking printouts. Dithered Only produces output that is great for monochrome (2 color) images. If your image was a color image, the printed output tends to look a little grainy. This mode of output also tends to take a lot longer to produce. NOTE: It might be noted that on some DOT matrix printers the DITHERED ONLY output looks better than the Halftone options! Smoothing is a toggled option. If you select it, it changes from the current selection. Yes and No are the only settings for this option. If set to YES, an image will be better reproduced on your printed output. Smoothing only occurs if the image has to be shrunk to fit into the printed output size. There is NO smoothing when enlarging images to fit on the paper. The smoothing appearance can look good for some types of images and poor for others. Play with the smoothing to see which mode performs best for you. In general, smoothing always gives you better results. Setting Margins You can set the TOP and LEFT margins for the printed output. You can also indicate if you want the output CENTERED on the page. These margin controls are very flexible. __________________________________________________________________________ GIF-REED 59 __________________________________________________________________________ Setting Printed Width You can set the printed output width and height. It is possible that by choosing a very narrow print width and a very tall print height that your printed output will look very skinny. You can also choose to have your printed output adjusted for aspect. Aspect is the thing used to make sure circles look like circles when printed instead of eggs when printed. If you choose to keep the aspect ratio, then the largest possible image that can fit into the print width and print height will be printed. The output will NOT look skinny or fat. It will look just right. NOTE: A width or height of .25 is as small as you can input. Values smaller than this will result in an error beep. Values greater than 10.5 will also result in an error beep. Choosing A Printer You can choose between several different printers currently and more printers will be supported later! You can select HP Laser, HP Laser Jet 4, EPSON MX, EPSON FX, EPSON LQ. If you have an HP Laser 3, just pick HP Laser. GIF-REED has automatic default settings for each printer. For example: When you choose HP Laser, the default settings become HALFTONE-B and 300x300. If you choose EPSON FX, the default settings become DITHER ONLY and 240x72. This is so that if you don't want the play around with the different possible combinations of resolutions and quality options, the defaults picked are pretty much the optimum settings for the best looking output. Of course after you have selected a printer, you can go back and change the quality type and printer resolution! Controlling Printer Output You can also select where the printed output should go. The default is PRN. This is your 1st printer. If you selected LPT1 that would be the SAME as PRN. If you select LPT2 then your 2nd printer would be selected. You can also type in a filename (a short one). So for example: You could type in: C:\GIFPRN This would cause GIF-REED to send the printed output to a file called "C:\GIFPRN". This file could then be copied to your printer like so: C>COPY C:\GIFPRN PRN __________________________________________________________________________ 60 GIF-REED __________________________________________________________________________ This would in effect print the picture. You could also take that file and copy it to a floppy and then take the floppy to a different machine with a printer that you wanted to print to and then do the above command to copy the file to the printer. Picking A Resolution As a rule of thumb the highest resolution available is the best choice for laser printers. For EPSON printers, the next to the highest resolution is usually the best choice. So for EPSON FX/MX printers 120x72 would be the best, NOT 240x72. This is because the highest resolution prints TOO dark. For EPSON LQ type printers 180x180 is the best, NOT 360x180. Again this is because the 380x180 prints TOO dark. This is because of the way the print heads work on DOT matrix printers. NOTE: The lower the resolution the FASTER it is to print. For example: 75x75 would result in quicker printouts than 300x300 for HP Laser printers. Of course quality is sacrificed. Other Commands If, after messing around with different options, you decide you want the print options defaults loaded, use option 15. This reloads the print options from the configuration file. If you decide you don't want to print the image just press ESCAPE. If you want to print the image with the current settings just press "P". NOTE: Any settings that have been changed are NOT updated in the configuration file. You MUST press ALT-U from the main file list menu to save the printer configuration out. Controls while printing If you press ESCAPE while printing, the printing process stops and whatever was sent to the printer is then printed. Any other key pressed while printing will NOT do anything except exercise your fingers! As the image is being printed you will see a black & white (Zebra) line scrolling down your screen. Once it reaches the bottom, the next page of graphics is displayed and the black & white line starts from the top again. This way you can see at all times exactly where the program is in the printing process. Advanced Printing Capability Special Printer Initialization __________________________________________________________________________ GIF-REED 61 __________________________________________________________________________ You can now send the printer your very own customized printer initialization codes. These codes will be sent to your printer BEFORE any printing has started. This way you can control your printer fully. We also added the ability to send the printer customized printer codes AFTER the image is printed. The way you build the customized codes is easy. There are TWO files to create: 1. GIFVINIT.PRN (Codes to send BEFORE print starts) 2. GIFVPOST.PRN (Codes to send AFTER image prints) If either of these files exist in the GIF-REED directory at the time of printing, they will be scanned for printer codes to send to the printer. For example: If you wanted to send to the printer an ESCAPE, then an uppercase A and then a return; You would put in the GIFVINIT.PRN file the following: 27,"A",13 The 27 is the ASCII code for ESCAPE. The 13 is the ASCII code for return (ENTER). The "A" will be sent to the printer directly. In fact ANYTHING inside QUOTES will be sent to the printer WITHOUT translation. So for example, you could send: "This is a cool IMAGE!",13,13 This would send the title "This is a cool IMAGE!" (without the quotes of course) to the printer! Then 2 (two) line feeds will be sent. NOTE: This capability is NOT for most people. Only use it if you need to and know what ASCII codes to send to your printer! NOTE: ANY line in the GIFVINIT.PRN or GIFVPOST.PRN files that start with a ";" (semicolon) will be ignored. This is so that you may put comments in these files without actually sending the comments to your printer! For example: If your GIFVINIT.PRN file has: ; ;Indicate to use legal sized paper! ; 27,"*A" ; That's all folks! The only thing sent to the printer would be an ESCAPE (27) and then "*A" without the quote marks. All of the other lines would be ignored. In fact BLANK lines are ignored too! HINTS: Possible uses for this feature might be to RETRACT your paper before printing, selecting which paper tray to load from if your printer supports multiple paper inputs. You could also use it to put your laser printer into landscape mode. You might also use it to force a particular color from a color ribbon. The uses are pretty much endless. __________________________________________________________________________ 62 GIF-REED __________________________________________________________________________ UNATTENDED Printing Of Multiple Files If you want to take a whole directory of image files and print them without needing to stay at the computer while the printing process is taking place, you can use the PRINT command from within a script file. For example: Let's say you have about 20 Catalog image files that you need to print. Of course you don't want to wait until each image is done printing before you can tell GIF-REED to go to the next image. The script file called GIFV.SLW contains the code to print (UNATTENDED) all of the images in the E:\CAT directory. Here is what's in the GIFV.SLW file: ********* START OF FILE ************* ; ; GIFV.SLW ; Print all my gif catalogs ; change-path E:\cat\*.gif :loop loadnext :exit rotate print goto :loop :exit ********* END OF FILE ************* The reason for the ROTATE command is so that the images would be printed sideways. This way you can get a larger printed image (if the original image is wider than it is tall). NOTE: Please take note that the semi-colon (;) and colon (:) are not to be confused with each other. The semi-colon (;) indicates that the line is to be ignored and treated like a comment. A line that starts with a colon (:) indicates a label to which another line in the script can issue a jump type of command to. The GOTO :LOOP command jumps the script program back to the label called :LOOP. The only way this script file can exit is by the LOADNEXT :EXIT command. This command says to get the next image file loaded and if there are NO more image files to jump to a label called :EXIT. Of course :EXIT is that last statement. Once this statement is reached the script file ends. BEST Printing Modes If you are using a laser printer, pick the highest resolution (such as 300x300 or 600x600 for HP Laser 4). This will give finer looking detail. Also pick Halftone B as the quality type. __________________________________________________________________________ GIF-REED 63 __________________________________________________________________________ If you are using a DOT MATRIX printer, pick 120x60 or 120x72 depending on if you are using an EPSON LQ or earlier EPSON. Picking the 240x?? resolution actually produces POORER quality because of the way the pins fire from the print head. The only kind of image that looks better in the 240x?? mode is line art, NOT SCANNED images such as pictures. Pick Dither Only as the quality type. Controlling Brightness and Contrast If you want the image to appear brighter or darker, use the CTRL-10 or CTRL-F9 key commands while viewing the image. Then select to print with the "P" command. If you want the image to have less or more contrast, press the CTRL-F7 or CTRL-F8 key commands while viewing the image. Then select "P" to print. __________________________________________________________________________ 64 GIF-REED __________________________________________________________________________ Puzzle-Fun Puzzle fun is a term we use to describe our entertainment mode. When viewing a picture just press ALT-E to enter entertainment mode. You can pick from one of three games. Slide-It, JigSaw-It or Guess-It. Each of these games have an Easy, Hard and Expert mode of play. Slide-It If you choose Slide-It, your picture will become jumbled up. Its up to you to move the squares around on the screen with the Up/Down/Left and Right arrow keys to solve the puzzle. Only one piece can move either UP, DOWN, LEFT or RIGHT at any point in time. The squares are numbered from 1-9, 1-16 or 1-25 depending on the level of the game you choose, starting with the top row as being 1 thru ?. In actuality, since the upper left square is blanked out, that square is considered a -1 and NOT a 1. NOTE: The easy mode doesn't have the SWAP feature because it's so easy you will not need to use it. The EXPERT mode also doesn't have the SWAP feature because if you are an EXPERT you shouldn't have to rely on cheating features to solve the puzzle. JigSaw-It JigSaw-It is a little easier than Slide-It. This is because you can point to a piece and then tell where that piece should go. It's more like putting together a JIGSAW picture puzzle on your screen. Since it's a little easier, the Easy, Hard and Expert modes have MORE squares to deal with. Guess-It Guess-It is very similar to JigSaw-It except that all the pieces start off being BLANKED out. When you select a piece to move, it shows what part of the image is in the square. You then select where you want the piece to go to. If you chose incorrectly, the piece goes back to black. If you chose correctly, then the piece stays visually on the screen. General Operations Although each game operates a little differently, they have a lot of features in common. Press F1 for help on the game. It is game specific help. It shows you a quick reference card of what keys do what when inside the game. It also tells you how to win and how the game operates. If you want to mix the picture up press the "J" key to jumble it up. If you want to see what the original picture looked like, press the "V" key to view the original image. __________________________________________________________________________ GIF-REED 65 __________________________________________________________________________ If you want to see what order the squares belong in press the "O" key to show the order of the squares. If you don't like the cute sounds or it's late at night you can press "N" to toggle the noise on and off. If you decide you are not smart enough to unscramble the picture you can press "C" for cheat. This will unscramble the picture. This only works in Slide-It in the Hard mode. If you just want to cheat a little bit, press "S" to swap two squares that are next to each other! This only works in the Slide- It game. When you are done with the entertainment mode just press ESCAPE and you will be brought back into the NORMAL viewing mode of your ORIGINAL picture. NOTE: There are 3 levels of each game in PuzzleFun. 1. Easy 2. Hard 3. Expert Scoring System PuzzleFUN has a scoring system built in. A perfect score would be 5000. It's impossible to achieve this high of a score. Every second you take to solve the puzzle takes 4 points away from your score. Every move you make takes 1 point away from your score. Everytime you use the SWAP cheat mode 100 points are taken away. Everytime you use the ORDER and VIEW features, 50 points are taken away. If you are playing Guess-It and make a wrong move, 50 points will be deducted. The goal is to achieve the highest possible score. __________________________________________________________________________ 66 GIF-REED __________________________________________________________________________ Slide Show Features/Operations Features Slide shows can be used to easily flip through a series of pictures without having to use the keyboard. This can be for pure pleasure or for business slides for presentations. It can also be used in trade shows where a constantly changing screen attracts attention. You can tell GIF-REED how many seconds you want to wait between each picture. You can choose between 0 through 9 seconds. You can indicate if you want any special effects during the slide show. You can choose from the following special effects: FADE: This option makes the picture fade into view and then fade out of view after the specified delay time is reached. BLIND: This option makes the picture come into view like a venetian blind. The images appears in stripes that get larger until the entire image is displayed on the screen. EXPAND: This option will start the image in the center of the screen and the image starts expanding outward until the entire image is displayed on the screen. MERGE: This option is difficult to explain other than it appears that the image is merging into the screen. Try it out and see if you like it. ZEBRA: This option is difficult to explain other than it appears that the image is forming on the screen like a Zebra's stripes. Try it out and see if you like it. RANDOM: This option makes it so that each picture that is loaded via the slide show will use a different (random) slide show effect. This makes for a less boring slide show. Try it out and see if you like it. __________________________________________________________________________ GIF-REED 67 __________________________________________________________________________ You can tell GIF-REED if you want the slide show to keep looping forever (great for trade shows), or to just loop through pictures once. You can perform a slide show on marked (tagged) files, or you can do a slide show based on category, score or keyword. These are very powerful features. If you assigned a score, category and/or keywords to all of your pictures, you will easily be able to select a slide show of all pictures that have a category such as SWIM- SUITS. Only the pictures that had a category of SWIM-SUITS assigned to it would be loaded in the slide show. __________________________________________________________________________ 68 GIF-REED __________________________________________________________________________ Operations To do a simple slide show, mark (tag) a few files using the SPACE BAR at the main file list menu. Press F10, then press RETURN. This starts the slide show with default options. If you want different options, press F10 and then select the option you want to change. Once the slide show starts, you can exit the slide show by pressing ESCAPE or by clicking the middle mouse button. If you had selected a large delay between images and you want to go to the next picture pronto, press PgDn or click on the right mouse button. If you decide that you want to stop on a picture, press the SPACE BAR and the image will stay on the screen. At this point you will be able to do whatever you can normally do to an image that is loaded, such as moving it, adding text and maybe saving it back out. Once finished messing with the picture, press PgDn and the slide show will continue. Hints You can change the time delay and special effects options by using your mouse. Just move the mouse to the lower right hand corner of your main file list menu screen. There you will find: GO:?L:?????:# The four fields are described as follows: "GO" can be clicked on to start the slide show instead of the F10 key. "?L" or "NL" can be clicked on to change the looping status. NL means no looping. The "?????" can have NONE, FADE, BLIND, XPAND, MERGE, ZEBRA or RANDM in it to reflect the special effect mode selected. If you click on it, you can flip through all of the various slide show effects. The "#" is a number from 0 through 9 which indicates the time delay between images. Just click on the number and it will increase one number at a time. Once you have the slide show options the way you like them, you can save the settings by pressing ALT-U and picking Option 1 or Option 5. This saves the main menu settings as well as all of the slide show options. This way you don't have to keep changing the slide show options to suit your needs everytime you load GIF-REED. Experienced Users If you press F10 at the main file list menu and select PERSONAL slide show, select a letter from A to Z. This will execute a SCRIPT file that executes a series of script commands that fully control the slide show. An example file called GIFV.SLE is provided as an example. In fact, GIFV.SLA through GIFV.SLZ are provided in this GIF-REED package. The letter you choose is added to GIFV.SL to create the full script file name. So, if you pressed G, the script __________________________________________________________________________ GIF-REED 69 __________________________________________________________________________ file GIFV.SLG would be executed. Make sure that the script files are in the GIF-REED directory. They CAN NOT and WILL NOT be executed from anywhere else. If you are interested in learning more about the script language, see the section on Script Language Commands. __________________________________________________________________________ 70 GIF-REED __________________________________________________________________________ Catalog Features/Operations Features Catalogs are picture files that actually have a bunch of pictures in them. Each image in the catalog is (of course) smaller than the original image used to create the catalog. But, by being able to see more than ONE image on your screen at once, you can have a better feel for what you have. You can also search for a particular image faster! The more images you have in each catalog the quicker you will be able to find a particular picture. Of course you can go overboard and put TOO MANY pictures in a catalog so that you can't even make out what the original picture was. This is because the more images per catalog the SMALLER each image becomes in the catalog. Cataloging images is not a new idea. In fact, people have been doing this for years with photo albums. There are a few programs on the market that allow you to create catalogs of your pictures. Each one of them has certain restrictions or problems that make them less than useful. GIF-REED is setting the NEW standard in catalog generation and viewing. With GIF-REED you can easily create a series of catalogs of your favorite subdirectory where you have pictures stored. You can do this with ONE DOS command or through ONE keystroke at the GIF-REED main menu. You can even point to an image in the catalog and click a mouse button and poof, the original picture used to create the small image in the catalog will be brought up for display! As if this weren't cool enough, you can even point to an image in the catalog and click a mouse button and the ORIGINAL file becomes marked (selected) for copying. You can select as many as you wish from the catalog. You can of course mark and un-mark files in case you made a judgement error. Operations There are TWO (2) ways you can create catalogs. You can have GIF- REED automatically create a series of catalogs from any directory that has picture files in it, by using a DOS command line parameter to GIF-REED. You can also have GIF-REED create catalog file(s) by using the CTRL-C command from the main files list menu. Making Catalogs From Command Line If you choose to use the DOS command line method, there are many different options that you can give GIF-REED to control the resulting catalog. They are as follows: /C:catname {REQUIRED} /BBS:bbs_name {Sysop files generation} /DIR:dir.lst {Sysop files generation} /DATE:mm/dd/yy {Filter option} __________________________________________________________________________ GIF-REED 71 __________________________________________________________________________ /SIZE:#### {Filter option} /RESX:#### {Filter option} /RESY:#### {Filter option} /COLORS:#### {Filter option} /C:catname is the only option that is REQUIRED. The others are for filtering and SYSOP files generation. Below is a sample DOS command to generate a series of catalogs: C>GIFV D:\GIFS /C:BIRDS This is the simplest form of catalog generation from the DOS command line. This will take EVERY picture from the D:\GIFS directory and create a series of catalogs named BIRDS_##.GIF where the ## indicates a 2 digit number. The /C:xxxxxx parameter indicates the resulting catalog filename. Only the first 6 letters in the filename are used so that a 2 digit number can be appended to the filename. ALL catalogs produced using the above technique will be placed in the GIF-REED program directory area. If you need to specify WHERE the resulting catalogs will go then you can use the following format: C>GIFV D:\GIFS /C:D:\CAT\BIRDS This tells GIF-REED to place the resulting catalog(s) in the D:\CAT directory with a filename of BIRDS_##.GIF. No titles are put into the catalogs unless specified. In order to specify a Title image file to be placed at the TOP of your catalog, you can use the following format: C>GIFV D:\GIFS /C:BIRDS /T:TITLE.BMP This produces your catalogs as normal with the exception that EACH catalog produced will have a GRAPHIC Title (Caption, Header, whatever) placed at the TOP of each catalog. The name of the title file is selected with the /T:xxxxxxx.xxx parameter. You can use .GIF, .BMP, .PIC, .PCX files for your title file. The title file MUST reside in the GIF-REED program directory. You can use any paint program for creating the Title file as long as the paint program produces a .GIF, .BMP, .PCX, .PIC output file. You can even use GIF-REED to add text to a picture and then TRIM (CROP) off the rest of the image so that all that is left is the TEXT. Then save this image out to a NEW file that will later be used as a title file. NOTE: Try not to make the Title file TOO tall. This would cause the catalog to not have much room for the actual images. If the Title file is NOT as wide as the resulting catalog file, the Title will be CENTERED in the catalog file. __________________________________________________________________________ 72 GIF-REED __________________________________________________________________________ All of this is great, but what if you wanted the titles to be placed at the BOTTOM of each catalog file? Simple, use the following command: C>GIFV D:\GIFS /C:BIRDS /T:TITLE.BMP /T:T- The last parameter of /T:T- indicates to force the catalog titles to the BOTTOM. Likewise a /T:T+ would force the title to the TOP of each catalog file. By now you are probably wondering how GIF-REED knows what catalog size to use and how many rows of pictures should go in the catalog? Well that's very understandable since there is NO indication on the DOS command line parameters as to this type of configuration. GIF- REED gets ALL of it's cataloging configuration defaults from a file called GIFV.CAT. You can customize the cataloging features of GIF- REED (using the CTRL-C command from the main menu) and then save them out (using the ALT-U command from the main menu). This way each time you run GIF-REED to catalog, it will know what settings to use. Using Filters To Limit Pictures Let's say you want to catalog a directory, but you want to make sure that NONE of the 320x200 images get in the catalog. Let's also say you want to make sure that if the file size is less than 300,000 bytes you want to skip it. You could use the following example to achieve this. C>GIFV D:\GIFS /C:BIRDS /SIZE:300000 /RESX:320 /RESY:200 As you can see by the above example, any file less than 300000 bytes will not get included into the catalog. Likewise if a file is less than 320 dots wide or 200 dots tall, it will be skipped too. The /DATE filter has a special format. It must be MM/DD/YY. Even if you are in Germany, you must follow the MM/DD/YY format. Also if the day or month is a single digit, it must be preceded with a zero. For example: /DATE:7/4/93 {Incorrect} /DATE:07/04/93 {Correct!} The /COLORS filter can be used to make sure images that have less than a certain number of colors in them are skipped from the catalog process. ALL 24 BIT images are loaded by GIF-REED as having 16000 colors. So if you wanted to tell GIF-REED to catalog only the 24 BIT images, you could do so by using /COLORS:16000 as a parameter. Special Considerations __________________________________________________________________________ GIF-REED 73 __________________________________________________________________________ NOTE: You MUST specify a catalog filename using the /C:xxxxx command or else NO catalogs will be produced. NOTE: Making catalogs using the command line options WILL overwrite any catalogs that exist by the SAME name. This is so that you can re-run a catalog without having to delete the older catalog files first. This is different than the MANUAL mode of making catalogs from the files list menu (discussed next in this chapter). In manual mode, the older files are NOT overwritten. Making Catalogs From Files List Menu You can configure GIF-REED's cataloging features with the CTRL-C command from the files list menu. Press CTRL-C from the files list menu and a Catalog Configuration screen will pop up. From this screen you can select a number of different options. They are as follows: 1. Catalog Size (320x200 through 2048x1536) 2. Catalog Rows (2 through 10) 3. Select Graphics Title Name 4. Place Title at top or bottom of catalog 5. Gray or Color catalog 6. Black or White catalog background color Once all of this wonderful configuration information has been entered, it's a good idea to save this out with the ALT-U command (from the files list main menu) to save your Catalog Configuration options. While in the Catalog Configuration screen you can press "S" and a single catalog will be produced using the files STARTING at the point where your file cursor happens to be. The file cursor is the highlight bar that moves with the arrow keys to point to a file to view. This allows you to make a (S)ingle catalog easily without having to tag (mark) any files. If you were to press RETURN (ENTER) at the Catalog Configuration screen, the file STARTING with the file cursor all the way to the END of the files list will be cataloged using MULTIPLE catalogs if needed. This is an easy way to catalog an entire directory. If you were to press "M", all of the MARKED (tagged) files would then be cataloged into multiple catalogs if needed. NOTE: Beware that since the new catalog files will NOT overwrite existing catalog files, the number of the catalog produced may NOT be what you expected. If you already have: CAT___00, CAT___01 and CAT___03, then the NEW catalog files produced will use the filenames of CAT___02, CAT___04, CAT___05 and so on... The simplest approach is to just delete the older catalog files when done with them. Cataloging REQUIREMENTS __________________________________________________________________________ 74 GIF-REED __________________________________________________________________________ NOTE: Every catalog produced contains information in it as to where each of the individual source files came from. This way we can load the original picture when selected. However, this feature can turn against you. Read the following paragraph VERY closely. Let's say that you catalog a directory called "C:\PICS\FROGS". The catalog now knows to look at "C:\PICS\FROGS" for all of the source files. Let's say you RENAME the directory to "C:\PICS\ANIMALS". You can see that the catalog wouldn't be able to find it's source files. HENCE you couldn't point to an image and click on it to load up the original picture. Thus you MUST NEVER change the pathnames to your picture files, UNLESS you want to re-create the catalogs again. Now let's say you move the files to a different drive "D:\PICS\FROGS". Again GIF-REED won't be able to load the source files. BUT if you place the catalogs on the SAME drive as the source files, GIF-REED will assume that the only thing changed is the drive letter. It would ASSUME that the correct drive letter is the same drive letter as where the catalog is. This way it would KNOW to look at "D:" because your catalog was on "D:". Exceptions To The Rule Let's say that you want to give some picture files and the catalogs to a friend. He of course won't have the correct directories on his hard drive. In order to resolve the fact that the drive and directory information may NOT match what the catalog file wants, just place the catalog files in the SAME directory as the source files. This way if GIF-REED can't find the files the normal way, it would simply give up and try, as a last resort, the SAME directory as the catalog file. This way your friend can look at the catalog files and select images to view in original format. Disk Space REQUIREMENTS NOTE: The more rows of pictures in a catalog (ie:8x8) the poorer the quality of the final catalog file! It seems that 4, 5 and 6 rows produce excellent results, 7 and 8 rows produced very good results and 9 and 10 rows produce just good results. Play with the different number of rows to suit your tastes in quality. NOTE: Once you start the cataloging process you can abort out by pressing any key while the pictures are being gathered up. NOTE: Make sure you have at least 3 to 6 megs free in your TEMP drive area. If you want to know exactly how much space will be needed, take the size of your Catalog Image and multiply times 4. For example: if your Catalog size is 800x600 then the BASE space needed would be 800 x 600 x 4 = 1920000 bytes. Or about 2.0 megs. In addition to this BASE amount, you will also need enough disk space to hold the LARGEST image (times 4). For example if the largest image in the Catalog was a 1024x768, then the additional overhead would be 1024 x 768 x 4 = 3145728 bytes. Or roughly 3 megs. This would mean that you would need about 2+3 = 5 megs of FREE disk space in your TEMP drive area. __________________________________________________________________________ GIF-REED 75 __________________________________________________________________________ The MOST common catalog size is 800x600 and the most common image size is 640x480. This would require 3148800 bytes or about 3 megs of disk space! THIS SPACE IS REQUIRED ONLY WHILE MAKING THE CATALOGS. WHEN VIEWING THE CATALOGS, LESS TEMP SPACE IS NEEDED! Hint Hint Hint HINT: If you want to save some disk space and time, you can create GRAY image catalog files. Of course these don't look as nice, but you will save a bit of disk space and time. HINT: If you are creating catalogs that are to be printed, I would suggest selecting a WHITE background color for the catalog images. This way LESS toner (ink) will be used in the printing of the catalogs. Using Your Catalogs Once your catalogs are created you can of course view them to see what pictures you have on you system quickly. But there are a couple of other special (nifty) features that GIF-REED allows you to do with your catalog files. * You can select a picture to view from the catalog * You can mark files to be copied from the catalog Select A Picture From A Catalog In order to view a picture that was used to create an image within a catalog, just point your mouse to the picture in the catalog and quick click on the LEFT mouse button. POOF, the ORIGINAL image used to create the catalog will be brought up for display! At this point you can do anything with the image that you can normally do with GIF-REED. When done viewing the image, just press ESCAPE and you will be brought back to the catalog that you started from. Mark Files From Catalog For Copy Just bring up a catalog image for display. Then move the mouse pointer on top of an image you want to copy and quick click the RIGHT mouse button. This will MARK (tag) the file for copying later. Move the mouse around the catalog and mark as many images as you like. Each image marked will be indicated by a THICK RED box around the image. If you make a mistake and mark an image you didn't want marked, then just click the RIGHT button again and POOF, the image will be un-marked (indicated by a THICK BLUE box around the image). Once you are done marking and unmarking images, press ALT-C and you will be prompted for a destination path. If copying to a floppy, enter A: or B: and the RETURN. Keep in mind that if you are NOT sure if you want to tag a file, you can always quick click the LEFT mouse button to bring the __________________________________________________________________________ 76 GIF-REED __________________________________________________________________________ picture to full size to see if you really like it. Then press ESCAPE to go back to the catalog. Then mark it if you liked it! When copying the files (ALT-C), any files that don't copy properly (DISK FULL, Etc...) remain marked so that you can put in a new floppy or whatever and press ALT-C again. All files that did copy properly will be UN-MARKED with a THICK GREEN box around the image. Again, this is so that you can tell what files you have already copied so that you don't accidently waste time copying the SAME files. Special Notes NOTE: If you quick click the LEFT/RIGHT mouse button on a part of the catalog that is NOT used to display a picture (in between images), you will go to the PREVIOUS/NEXT picture in the file list, provided you have NOT tagged any files for copying. If you have tagged files, you will be asked if you really want to exit the current catalog image. You can press the middle button or the ESCape key to ESCape out of the catalog picture. If at anytime it appears that you want to ESCape out or go to the next picture in the files list, a check is made to see if ANY images in the catalog were tagged for copying. If there are, you are asked if you really want to get out of the current catalog. If so, all tags are removed. __________________________________________________________________________ GIF-REED 77 __________________________________________________________________________ Using GIF-REED Under Windows 3.x If you plan to use GIF-REED while inside of Windows, you should make sure that you are familiar with DOS subdirectories and the Windows PIF Editor. If NOT, I suggest that you familiarize yourself with the Windows PIF editor. The PIF editor is really quite easy to use. Automatic Installation Of GIF-REED For Windows 3.x Run GIFVWIN.EXE at the DOS prompt like so: C>GIFVWIN This program automatically updates the GIFV.PIF file to indicate which subdirectory you have placed GIF-REED. This program also COPies the GIFV.PIF file into your Windows directory. The next step is to add GIF-REED to the Program Managers' list of programs to run. The section "Creating A Windows Menu Item With ICON" discusses how to do this. Manual Installation Of GIF-REED For Windows 3.x The first thing you'll want to do is to Copy the GIFV.PIF file into the Windows directory. For example: If you've stored GIF-REED in a directory called D:\GIFREED then you would type: D>COPY D:\GIFREED\GIFV.PIF E:\WIN31 This of course assumes that your Windows 3.x directory is located in "E:\WIN31". If not, replace "E:\WIN31" with your Windows 3.x subdirectory. The next step would be to customize the GIFV.PIF file for use with Windows. Make sure you load Windows first. Then follow these steps carefully, if you are a Windows novice: (1) Put yourself at the Program Manager. (2) Select WINDOW (3) Select MAIN (4) RUN PIF-EDITOR (5) Select FILE (6) Select OPEN (7) Pick GIFV.PIF as file to edit. (8) Enter proper path and program name. This would be path & filename. For example: If GIF-REED was stored in D:\GIFREED then enter "D:GIFREED\GIFV.EXE" without the quotes of course. (9) Enter the Start-Up directory. This would be the SAME as the GIF-REED directory. For Example: "D:\GIFREED" without the quotes of course. __________________________________________________________________________ 78 GIF-REED __________________________________________________________________________ (10) Select FILE (11) Select SAVE (12) Select FILE (13) Select EXIT. This concludes the updating of the PIF file with the PIF Editor. Easy? The next step is to add GIF-REED to the Program Managers' list of programs to run. The next section discusses how to do this. Creating A Windows Menu Item With ICON This step actually puts an entry in your Windows menu selection area. Of course you will have to decide where (what window) to put GIF-REED. I would suggest that you place it in either the NON Windows Applications or Windows Applications. Just follow these simple steps: (1) Put yourself in the Program Manager (2) Select WINDOW (3) Select Non-Windows Applications or Windows Applications (4) Select FILE (5) Select NEW (6) Select Program Item (7) Enter "GIF-REED" for program description. Enter "GIFV.PIF" for command line. (8) Select CHANGE ICON (9) Skip error message by clicking on OK. (10) Enter path and "GIFV.ICO" for icon name. For example if GIF-REED was stored in "D:\GIFREED" then you would type "D:\GIFREED\GIFV.ICO" then return. Only one icon should appear. Select this icon (it looks like mountains). (11) Select OK until back at Program Manager. You should now see a GIF-REED Icon that you can run. Once you have GIF-REED as a Windows ICON. You can double-click on it to run GIF-REED. While it's running you can switch back to Windows by pressing ALT-ENTER. This puts GIF-REED on hold so that you may do other Windows functions. When ready to get back to GIF- REED just double-click on the GIF-REED ICON and then press ALT- ENTER to put you into FULL screen mode. It's that simple to do. NOTE: If using GIF-REED under Windows, you should still try to use EMS memory for the picture buffer. Otherwise use XMS. And as mentioned before if you cannot, then use DISK. __________________________________________________________________________ GIF-REED 79 __________________________________________________________________________ SYSOP GIF-REED The SYSOP version of GIF-REED allows a SYSOP to download truckloads of GIF/BMP/PCX or PIC files. The SYSOP can then tell GIF-REED to produce catalogs of these files. These catalogs can be anywhere from 320x200 up to 2048x1536 in dimensions. They can also have up to 10 ROWS of thumbnail images within the catalog. Along with producing the catalogs, GIF-REED can optionally create and or append to a specified DIR TEXT file. The DIR file that you specify will be modified to show the NEW catalogs generated along with their appropriate file DATE & SIZE and description. You can choose between a long format or a short format for the description. Also you can place a TITLE on your catalogs so that you may advertise your BBS or whatever. We've provided a sample title file called GIFVTIT.GIF in this package. The typical way of building the catalogs and updating the appropriate DIR files is shown below: C>GIFV path /C:catname /T:title /BBS:bbs_name /DIR:filename "bbs_name" MUST be one of the following: PCBOARD {PCBOARD short format} PCBOARDL {PCBOARD long format} WILDCAT {WILDCAT short format} WILDCATL {WILDCAT long format} SPITFIRE {SPITFIRE format} QBBS {QBBS format} The "path" indicates where the images to be cataloged are kept. The "catname" is the name of the resulting catalog(s). The "title" is the name of an image file that is to be used as a graphic TITLE to your catalogs. The /BBS: command indicates what type of BBS support you want. So far the BBS's supported are PCBOARD, WILDCAT, SPITFIRE and QBBS. The /DIR: command tells where the resulting description file is to go or is currently located! BBS Formats Supported PCBOARD is used if you want the description file to contain a SINGLE line that indicates the FIRST and LAST images filenames in the catalog. PCBOARDL is used if you want a longer, more detailed, description of the files that are contained in the catalog files. This would __________________________________________________________________________ 80 GIF-REED __________________________________________________________________________ have a multi-line description that shows ALL of the images filenames in the catalog. WILDCAT is used if you want the description file to contain a SINGLE line that indicates the FIRST and LAST images filenames in the catalog. WILDCATL is the SAME as above except that the file size is included in the description. WILDCAT is used if you want the description file to contain a SINGLE line that indicates the FIRST and LAST images filenames in the catalog. SPITFIRE is used if you want the description file to contain a SINGLE line that indicates the FIRST and LAST images filenames in the catalog. Of course, it also contains the filename and file size. QBBS is used if you want the description file to contain a SINGLE line that indicates the FIRST and LAST images filenames in the catalog. Of course it also contains the filename and file size. Example use with PCBOARD With the above command format in mind you could do the following command. C>GIFV F:\GIFS /C:F:\GIFSUP\NEW /T:YOURS.GIF /BBS:PCBOARDL /DIR:F:\PCB\NODE1\DIR99 This command would take all images in F:\GIFS and catalog them up. The catalogs will be called NEW___00.GIF, NEW___01.GIF, NEW___02.GIF and so on. They will be stored in the F:\GIFSUP directory. These catalogs will also have your BRAND on it by placing a title at the TOP of the catalogs. The image used to create the title is read from a file called YOURS.GIF stored in the GIF-REED program directory. The resulting catalogs will have complete filenames & descriptions stored in PCBOARD format using the LONG format in the file called F:\PCB\NODE1\DIR99. If any entries are currently in the DIR99 file, they will remain. Here's what the example DIR99 file might look like: Image Catalogs DIR | Filename | | Size | | Date | |Description for this file | ============ ======== ======== ================================ NEW___00.GIF 164399 01-07-93 L-BUF144.GIF L-BUF150.GIF L-BUF151.GIF |L-BUF156.GIF L-BUF158.GIF L-BUF165.GIF |L-BUF176.GIF L-BUF190.GIF L-BUF192.GIF |L-BUF195.GIF L-BUF207.GIF L-BUF227.GIF |L-BUF244.GIF L-BUF245.GIF L-BUF246.GIF |L-BUF247.GIF L-BUF249.GIF L-BUF279.GIF __________________________________________________________________________ GIF-REED 81 __________________________________________________________________________ |L-BUF304.GIF L-BUF317.GIF L-BUF321.GIF |L-BUF326.GIF L-BUF332.GIF L-BUF349.GIF |L-BUF351.GIF L-BUF359.GIF L-BUF369.GIF |L-BUF374.GIF L-BUF377.GIF L-BUF386.GIF |L-BUF389.GIF L-BUF395.GIF L-BUF397.GIF |L-BUF402.GIF L-BUF406.GIF NEW___01.GIF 163745 01-07-93 L-DG-013.GIF L-HOOT25.GIF L-HOOT55.GIF |L-HOT045.GIF L-HIP007.GIF L-P&H-30.GIF |L-P&H-31.GIF L-PREG04.GIF L-PS-022.GIF |L-ROCK03.GIF L-ROCK06.GIF L-TL-AC1.GIF |L-ZENA00.GIF L-ZENA01.GIF L-ZENA02.GIF |L-ZENA03.GIF L-ZENA04.GIF L-ZENA05.GIF |L-ZENA06.GIF L-ZENA07.GIF L-ZENA10.GIF |L-ZENA11.GIF LEOSHA1.GIF LGTONGUE.GIF |MELLISA3.GIF MILK09.GIF MILK13.GIF |MKPP05.GIF MM-R-006.GIF MORGANA.GIF |PPEAKS2.GIF PPER0051.GIF ROCK238.GIF |ROCK242.GIF ROCKLOG3.GIF Example use with WILDCAT! C>GIFV F:\GIFS /C:CARS /T:YOURS.BMP /BBS:WILDCAT /DIR:FILE.LST This command would take all images in F:\GIFS and catalog them up. The catalogs will be called CARS__00.GIF, CARS__01.GIF, CARS__02.GIF and so on. They will be stored in the GIF-REED program directory area. These catalogs will also have your BRAND on it by placing a title at the TOP of the catalogs. The image used to create the title is read from a file called YOURS.BMP stored in the GIF-REED program directory. The resulting catalogs will have complete filenames & descriptions stored in WILDCAT format using a text file called FILE.LST stored in the GIF-REED program directory. If any entries are currently in the FILE.LST file, they will remain. This way you could process many directories of image files through a batchfile and produce just ONE text file that the WILDCAT utility program WCFILE would process. Example using a BATCH FILE Below is an example batch file assuming GIFV.EXE is in your path and that the path for GIF-REED is F:\GIFV: DEL F:\GIFV\FILE.LST GIFV F:\GIFS\CARS /C:AUTOS /T:TIT1.GIF /BBS:WILDCAT /DIR:FILE.LST GIFV F:\GIFS\SWIM /C:SWIM /T:TIT1.GIF /BBS:WILDCAT /DIR:FILE.LST GIFV F:\BIRDS /C:BIRDS /T:TIT1.GIF /BBS:WILDCAT /DIR:FILE.LST GIFV F:\PIC\SCANS /C:NEW /T:TIT1.GIF /BBS:WILDCAT /DIR:FILE.LST This batchfile would catalog up 4 (four) directories of image files and would place ALL of the resulting catalogs in the GIF-REED __________________________________________________________________________ 82 GIF-REED __________________________________________________________________________ program directory. In addition it would start from a blank FILE.LST file and have all of the catalog information stored in the FILE.LST file. The resulting FILE.LST file might look something like this: AUTOS_00.GIF Cataloged files 0131PICG.GIF - 0602PICP.GIF AUTOS_01.GIF Cataloged files 0607PICP.GIF - 0682PICP.GIF SWIM__00.GIF Cataloged files SI000012.GIF - SI000199.GIF SWIM__01.GIF Cataloged files SI000200.GIF - SI000240.GIF SWIM__02.GIF Cataloged files SI000241.GIF - SI000260.GIF BIRDS_00.GIF Cataloged files ROBIN012.GIF - ROBIN040.GIF NEW___00.GIF Cataloged files DS-X-234.GIF - DS-X-250.GIF NEW___01.GIF Cataloged files DS-X-251.GIF - DS-X-270.GIF NEW___02.GIF Cataloged files DS-X-300.GIF - DS-X-340.GIF This automated process should facilitate the posting of NEW gifs via the catalog method! This is a SYSOP's dream (hopefully)! This makes the processing of GIF/BMP/PCX/PIC files all automatic thus saving the SYSOP's valuable time. As a fellow SYSOP, I know there is never enough time in a day and anything to automate the process is a blessing. NOTE: You can NOT specify more than ONE /BBS: command when running GIF-REED. If you do, only the LAST use of the /BBS: command will be the one actually used. You MUST use the /C: command in order to AUTOMATICALLY generate the text file containing the file information and descriptions. HINT: If it appears that the catalogs aren't coming out in the format that you want, run GIF-REED in normal (manual) mode and press CTRL-C from that main file list menu. This brings up the catalog options menu. Select the settings you wish to change and or set. When done, press ALT-U to bring up the User Configuration menu. Select option 7 to save the Catalog Options Defaults. Then the next time you run GIF-REED in automatic mode, the default catalog options will be read from the saved configuration file. __________________________________________________________________________ GIF-REED 83 __________________________________________________________________________ Error Messages There are but a few error messages that will occur in the GIF-REED program. Most of them are easy to understand and the solutions are obvious. But, below are some of the less obvious error messages that may appear during the use of GIF-REED. Error in loading DOS SHELL! This error occurs when you press the ALT-F2 key to activate the DOS/BOSS function. After attempting to load a secondary DOS Shell, this message appears if there isn't enough memory or COMMAND.COM can't be found. Make sure that COMSPEC points to COMMAND.COM. Solution: Make sure you have at least 400K of free memory before running GIF-REED. Error in GIF Resolution: filename Error:## in GIF Descriptor: filename Not a GIF87a or GIF89a file, or header read error Error in GIF file! These error messages are indicators that the GIF file you are trying to load is corrupted or is not even a REAL GIF file. Solution: There is no solution. The picture file is BAD. Error opening temp file! NOT ENOUGH TEMP SPACE! When doing an operation that changes the picture, such as a shrink or enlargement, a TEMP file is created. If you run out of disk space in the TEMP drive, you'll get this error. Solution: Make sure that you have enough space in the TEMP drive area. Also MAKE SURE that the TEMP environment variable is set to an EXISTING PATH! NOT Enough EMS, or DISK Space, or Invalid TEMP Directory, or Too Many TSRs! This error message appears after you try to load a picture file. If you had selected EMS memory for the TEMP picture buffer and you don't have enough EMS memory to hold the ENTIRE picture, this error occurs. Also, if you had selected DISK as the TEMP picture buffer and you run out of disk space, you will get this message. Also, if you had selected DISK as the TEMP picture buffer and have TOO many TSRs, this error will occur. __________________________________________________________________________ 84 GIF-REED __________________________________________________________________________ Solution: Make sure that you have at least 400K of free DOS RAM before running GIF-REED. If using EMS or XMS memory for picture buffer, make sure you have enough of that kind of memory. Error opening file "filename" This error occurs if the file you are trying to load can't be opened to read in. This could indicate a network error or a damaged FAT! This should NEVER occur. Premature EOF in File! Some GIF picture makers don't properly produce a GIF picture file. The GIF format expects certain codes to be at the END of the GIF picture. If it can't find these CODES, you will see this error message. This picture will, however, stay on the screen for your viewing enjoyment. Solution: You have a bad file and there is NO CURE! Just get rid of the picture file unless you don't have another GOOD copy of it. Error in temporary file:## When loading a GIF file, if an error occurs in the TEMP area (EMS or DISK) you will see the error here. This should NEVER occur. You should call us at 1-317-253-8088 if it does. Solution: Call Software Matters Inc. Error in non-interlacing file! If you are viewing a picture that is stored in a INTERLACED GIF format, the picture file is converted to a NON-Interlaced format internally for viewing purposes only. If there was an error in the TEMP file used to do this, you will see this message. Solution: Free up some disk space where the TEMP variable is pointing. Error Saving Picture:## If you are doing an operation that changes the picture, like a TRIM/SHRINK/ENLARGEMENT or ROTATE, the picture is first saved to the TEMP drive. If the TEMP drive fills up, you will get this error! Solution: Free up some disk space where the TEMP variable is pointing. __________________________________________________________________________ GIF-REED 85 __________________________________________________________________________ Error Restoring Picture! If you are restoring a picture to its original look and the TEMP drive has an error, you will see this error appear. This should NEVER occur! Solution: Make sure the drive where the TEMP variable is pointing to doesn't have any BAD spots that have not yet been marked as unusable.. Error Enlarging Picture! Error Resizing Picture! Error Rotating Picture! These errors appear if the TEMP drive fills up during the operation indicated. Also, if the TEMP picture buffer has an error in it you will get these error messages. Solution: Free up some disk space where the TEMP variable is pointing. Error in Saving DIR Paths! If the drive that GIF-REED is stored on is full when you try to SAVE your search DIRECTORies, you will see this error message. Solution: Free up some disk space and try saving again. Error saving Options! If the drive that GIF-REED is stored on is full when you try to SAVE your configuration options, you will see this error message. Solution: Free up some disk space and try saving again. __________________________________________________________________________ 86 GIF-REED __________________________________________________________________________ Script Language Overview This section describes the script language that goes into the making of the script files. The script files are called "GIFV.SLx" where the "x" is between "A" and "Z". For example: A script language is similar to DOS's batch file language. The difference being, instead of executing a series of DOS commands, a series of GIF-REED commands are executed. GIF-REED comes with a script viewer/editor that allows you to create script files without having to use another program such as a word processor. If you do choose to use a word processor to create your script files, save the files WITHOUT formatting commands. You can use the DOS program called EDIT or EDITOR to edit/create script files too. There are many example script files in this package you can view to get the hang of what script files are good for and how to create them yourself. There are two ways of executing a script file: 1 From the main file list menu press CTRL-S. Then choose a letter from "A" through "Z" to pick which script file you want to look at. See section on Script File Viewer/Editor. 2. From the DOS command line. For example: C>GIFV /P:A This would execute the script file called GIFV.SLA that must be in the same directory where the GIF-REED program is. Script files can be used to perform a series of commands that you would normally do from the keyboard. It can be done to a series of files unattended so that you may be off doing something fun while the computer is working. The kinds of things that you can do with script files are: 1. Specialized Slide Shows 2. Batch conversion of graphics files 3. Batch report files 4. Batch printing of picture files 5. Batch addition of comments to GIF files 6. Things I probably haven't thought of yet For example: You could set up a script to take ALL GIF files and sort the color map. Then remove the top 16 colors in the color map (because of Windows). Then reformat them to BMP files. (See GIFV.SLH) __________________________________________________________________________ GIF-REED 87 __________________________________________________________________________ NOTE: IF YOU CAN'T FIGURE OUT HOW TO USE THE SCRIPT LANGUAGE, YOU SHOULDN'T USE THE SCRIPT FILES! With the script language you can create personalized slide shows that show specific images in specific order with customized delays. You can even create a MOUSE operated slide show. This use of the script language makes it a glorified slide show viewer. However, there are more important tasks that can be accomplished via the script language. You can perform automated processes on your images. For example, you can create a script file that would go through all of your GIF and/or BMP and/or PCX and/or PIC files and rotate them clockwise and then turn them into a gray scale color image. This can be handy if you have an image printing program. By making the images gray, the printing program won't have to deal with color optimization. By rotating the image, you won't have to worry about your printing program being able to print landscape. There are unlimited abilities with what you can do with the script language! The script language is REAL time. This means that errors are detected while the script is running. No pre-scanning of the script file is done for syntax errors or missing files. If an error occurs in the processing of the script, that line is ignored and the next line is read. If you find that your script file puts you into an endless loop (never ending), you can exit ANY script by pressing ESCAPE. Any labels that need to be defined because of GOTO :LABEL reference should start with a colon ":". For example: CHANGE-PATH E:\GIFS\*.GIF DELAY 5 :LOOPHERE LOADNEXT :EXIT GOTO :LOOPHERE :EXIT This script file would load all of the .GIF files from the E:\GIFS directory. Each slide image would have a 5 second pause before advancing to the next image. Once no more images were found, the program script would exit. The format of each script line can have spaces preceding the command or label. In fact, TABS can be imbedded in the lines too. All TABS and spaces will be ignored during processing. This is so you can make your script files look pretty with proper indention and such. You may place ONLY ONE script command per line. Even though only one script command may go on a line, you can still have a comment on the line. You can have the comment following the command. For example: MIRROR ;This will mirror image the file __________________________________________________________________________ 88 GIF-REED __________________________________________________________________________ The above example shows that you can place a comment on the actual script command line. ;This will mirror image the file MIRROR The above line is incorrect. The entire line would be treated as a comment. The MIRROR command would be ignored. This is because anything AFTER the semicolon ";" is considered part of the comment. So for this reason, you should place all comments AFTER the command or on a seperate line by itself. NOTE: Any script command line that STARTS with a semi-colon ";" is considered a comment line and is NOT processed. For example: ; Load G:\CINDY.GIF This script line would NOT load the CINDY.GIF file. Instead it will be treated like a comment line. Feel free to sprinkle comment lines throughout your script file so you may understand how the script file works at a later date (after you've forgotten what it's supposed to do). NOTE: All configurable settings such as Slide Show Type and Res Locking settings are NOT altered before running the script files. In otherwords if you want to be sure that the script you create has a slide show that uses the FADE IN/OUT technique, you MUST specify the script command SLIDE-TYPE-FADE. Otherwise the slide show may use the normal mode or the BLIND mode depending on how you have set up your settings. There are many script file commands that can be used. Below is a list of all script file commands grouped in related sections: Commands That Control Script Logic Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T END GIFV.SLN T G GOTO LABEL MOST SCRIPT FILES T G IFINT LABEL GIFV.SLD T G IF-LAST-FILE LABEL GIFV.SLR T G IF>=320X200 LABEL like IF>=640X480 T G IF>=640X400 LABEL like IF>=640X480 T G IF>=640X480 LABEL GIFV.SLE T G IF>=800X600 LABEL GIFV.SLE T G IF>=1024X768 LABEL like IF>=640X480 T G IFBMP LABEL GIFV.SLQ T G IFGIF LABEL GIFV.SLQ T G IFPCX LABEL GIFV.SLQ T G IFPIC LABEL GIFV.SLQ T G IFEXIST FILENAME LABEL GIFV.SLF T G IFBUTTON-L LABEL GIFV.SLN, GIFV.SLM T G IFBUTTON-R LABEL GIFV.SLN, GIFV.SLM T G IFBUTTON-C LABEL GIFV.SLN, GIFV.SLM T G IF V{1-10}{<,>,=}{###} LABEL GIFV.SLI, GIFV.SLJ __________________________________________________________________________ GIF-REED 89 __________________________________________________________________________ T G GOSUB LABEL GIFV.SLJ, GIFV.SLK T G SUB-END GIFV.SLJ Commands That Set & Display Variables & Messages Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T G DISPLAY V{1-10} GIFV.SLI, GIFV.SLQ T G ECHO Message Text GIFV.SLI, GIFV.SLU T G SET V{1-10} {###,+,-,system} GIFV.SLI, GIFV.SLJ Command To Point To A Path Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T CHANGE-PATH {Valid Path,%1-%9} GIFV.SLR, GIFV.SLV Commands To Do File Operations Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T G FILE-COPY Destination LABEL GIFV.SLR T G FILE-MOVE Destination LABEL GIFV.SLR T G FILE-DELETE LABEL GIFV.SLR T G FILE-RENAME FileName LABEL GIFV.SLR T G SUB-CREATE {Valid Path,%1-%9} LABEL GIFV.SLR Commands To Load Pictures Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T LOAD Image FileName GIFV.SLF T LOADNEXT LABEL GIFV.SLC T LOADPREV LABEL GIFV.SLC T SKIPNEXT LABEL GIFV.SLD T SKIPPREV LABEL GIFV.SLN Commands To Control Slide Show Effects Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T SLIDE-TYPE-NORMAL GIFV.SLE T SLIDE-TYPE-BLIND GIFV.SLE T SLIDE-TYPE-FADE GIFV.SLE T SLIDE-TYPE-EXPAND GIFV.SLE T SLIDE-TYPE-MERGE GIFV.SLE T SLIDE-TYPE-ZEBRA GIFV.SLE T SLIDE-TYPE-RANDOM GIFV.SLE Commands Used While Image Is Displayed Modes Command Parameters Sample Script Name ---------------------------------------------------------------- G CENTER GIFV.SLO __________________________________________________________________________ 90 GIF-REED __________________________________________________________________________ G FLIP GIFV.SLP G GRAY GIFV.SLB G INVERT SAME AS NEGATIVE G MIRROR GIFV.SLP G NEGATIVE Similar to Invert G ROTATE GIFV.SLP G REDRAW Similar to MORE-RED G RES+ GIFV.SLO G RES- GIFV.SLO G PRINT GIFV.SLP G WRITE {B,G,P,C} {1,2,3,filename} GIFV.SLB, GIFV.SLD G BRIGHTER Similar to MORE-RED G DARKER Similar to MORE-RED G MORE-CONTRAST Similar to MORE-RED G LESS-CONTRAST Similar to MORE-RED G MORE-RED GIFV.SLG G LESS-RED Similar to MORE-RED G MORE-GREEN GIFV.SLG G LESS-GREEN Similar to MORE-RED G MORE-BLUE GIFV.SLG G LESS-BLUE Similar to MORE-RED G MORE-REDDER GIFV.SLG G LESS-REDDER Similar to MORE-RED G MORE-GREENER GIFV.SLG G LESS-GREENER Similar to MORE-RED G MORE-BLUER GIFV.SLG G LESS-BLUER Similar to MORE-RED G RESET-COLORS GIFV.SLG G SORT-COLORS GIFV.SLS G ADJUST-FOR-WINDOWS GIFV.SLV Commands To Control Printing Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T G PRINTER {Filename} GIFV.SLQ T G PRINTER-ON GIFV.SLQ T G PRINTER-OFF GIFV.SLQ T G PRINTER-FF GIFV.SLQ Commands To Control Mouse Operations Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T G MOUSE-CONTROL-ON GIFV.SLN, GIFV.SLM T G MOUSE-CONTROL-OFF GIFV.SLN, GIFV.SLM Commands To Control Debugging Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T G DEBUG-ON GIFV.SLK T G DEBUG-OFF GIFV.SLK __________________________________________________________________________ GIF-REED 91 __________________________________________________________________________ General Purpose Commands Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T G BEEP {###} GIFV.SLC, GIFV.SLG T DELAY {###} GIFV.SLC T G ENTER GIFV.SLQ T G SYSTEM {DOS COMMAND} GIFV.SLG T TEXT GIFV.SLG T G WAIT {###} GIFV.SLI, GIFV.SLG Commands That Change The NEXT Images Resolution Modes Command Parameters Sample Script Name ---------------------------------------------------------------- T RES {###} GIFV.SLO T RES-LOCK GIFV.SLO T RES-UNLOCK GIFV.SLO T RES-UP GIFV.SLO T RES-DOWN GIFV.SLO T EGA-MODE GIFV.SLT T VGA-MODE GIFV.SLT T G EGA-COLOR-ADJUST {ON,OFF} GIFV.SLT T G KEEP-SCREEN-SIZE {ON,OFF} GIFV.SLT The "T" indicates that the command can be used while the script is NOT displaying an image. If an image is being displayed at the point in time that a command with ONLY a "T" is encountered, the command is processed and the Image Display Mode will change to FALSE. This means that if a command that can only be used while an image is displayed ("G" ONLY) is encountered, an error message will result. The "G" indicates that the command can be used while the script IS displaying an image. If the command is "G" ONLY, then if Image Display Mode is FALSE then an error message is displayed. Otherwise the command is processed on the picture. If a command has both "T" and "G", they can be executed at anytime. The parameters field indicates if any parameters are needed for a command. Anything in the "{}" indicates valid values to enter. A "###" indicates a number. LABEL should be supplied. If NO label is supplied on a command that indicates a LABEL, NO branching in the script file will take place. Complete Script Language Description Commands That Control Script Logic END The END command HALTS execution of the script file and EXITS. __________________________________________________________________________ 92 GIF-REED __________________________________________________________________________ GOTO LABEL The GOTO statement jumps to location where LABEL can be found in the script file. IFINT LABEL IFINT tests to see if the next image to be loaded is a GIF Interlaced file. If so, control jumps to LABEL. IF-LAST-FILE LABEL IF-LAST-FILE tests to see if there are NO MORE files to be processed. If there are no more files in the list, control jumps to LABEL. IF>=320X200 LABEL IF>=320X200 tests the next image size. If the next image is greater than or equal to 320X200 resolution, control jumps to LABEL. IF>=640X400 LABEL IF>=640X480 LABEL IF>=800X600 LABEL IF>=1024X768 LABEL The above tests are similar in nature to the IF>=320X200. IFBMP LABEL IFGIF LABEL IFPCX LABEL IFPIC LABEL These test for the file extension of the next file to load. If the extension matches, control jumps to LABEL. IFEXIST Filename LABEL If the filename indicated EXISTS in the currently selected directory then control jumps to LABEL. IFBUTTON-L LABEL If mouse control is ON, IFBUTTON-L detects if the LEFT mouse button was pressed to quit out of a picture. If the LEFT button was pressed, control jumps to LABEL IFBUTTON-R LABEL IFBUTTON-C LABEL These commands are similar to IFBUTTON-L, but testing for the RIGHT and CENTER buttons instead. IF V{1-10}{<,>,=}{###} LABEL The IF command tests the value of one of the 10 variables allowed. The test can be <(less than) or >(greater than) or =(equal). The ### is a number to test against. LABEL is where control jumps if the test is true. For example: "IF V4>10 :MORE" This statement checks to see if variable 4 is greater than 10. If so control jumps to ":MORE". __________________________________________________________________________ GIF-REED 93 __________________________________________________________________________ GOSUB LABEL This allows a procedure (routine, function) with the name LABEL to be executed. Once the routine is finished, control transfers back to the statement following the GOSUB LABEL. NOTE: The called procedure must end with a SUB-END statement. SUB-END This statement indicates that the end of the subroutine is found. Control will transfer back to where the calling GOSUB statement was. Commands That Set & Display Variables & Messages DISPLAY V{1-10} This displays on the screen the current value of any of the 10 variables that you can manipulate. For example: "DISPLAY V2" would cause the contents of V2 to be displayed on the screen. ECHO text message This command allows you to print any text on the screen (much like the DOS ECHO command). Any text can be displayed. For example: "ECHO Have a nice day!" would result in "Have a nice day!" displayed on your screen. The ECHO command also allows for system variables to be displayed in the message. Enclose any system variable within % in the message. For example: ECHO %FILE_NAME% has %IMAGE_COLORS% colors in it! This would display something like: GIRL.GIF has 256 colors in it! The allowable system variables are described below in the SET command. There is one (1) additional system variable that the ECHO command can use that the SET command can't. It's the "FILE_NAME" system variable. The reason the SET command can't use it is because it's NOT a number! HINT: By using system variables in the ECHO command and using the PRINTER-ON command, you can essentially produce reports about your picture files! (See the GIFV.SLU script file for details.) SET V{1-10} {###,+,-,system} This command sets the value of any of the 10 variables allowed in the script language to a particular value. For example: "SET V3 100". This would set V3 to 100. You can also increment and decrement variables. For example: "SET V5 +". This would add 1 to the value of V5 and "SET V1 -" would subtract 1 from the value of V1. You can also set your variables to some of the various SYSTEM settings. For example: If you wanted V2 to contain the size of the next file to process, you would say "SET V2 FILE_SIZE". Below is a list of all system variables. __________________________________________________________________________ 94 GIF-REED __________________________________________________________________________ System variables List DEBUG_SWITCH If the DEBUG-ON option is turned on, this will be equal to 1, otherwise it will be equal to 0. PRINTER_SWITCH If the PRINTER-ON option is turned on, this will be equal to 1, otherwise it will be equal to 0. RES_LOCK_SWITCH If the RES-LOCK option is turned on, this will be equal to 1, otherwise it will be equal to 0. MOUSE_CONTROL_SWITCH If the MOUSE-CONTROL-ON option is turned on, this will be equal to 1, otherwise it will be equal to 0. RES_X This returns the value of the width of the next image to load. RES_Y This returns the value of the height of the next image to load. FILE_NUMBER This returns the number of files already processed in a particular path. FILE_ERROR This returns the error number of the last file operation (File-Copy, File-Move, File-Delete, File- Rename.) The meaning of the different values that FILE_ERROR can have are listed below: 0 File operation completed OK 1 Source file can't be found 2 Target area FULL, Subdirectory by same name, or Target NOT a valid drive. 3 Target area doesn't exist or Target drive full 4 Read/Write ERROR on file 5 NOT Enough Memory 6 NOT USED 7 Source and Target are the SAME 8 NOT USED 9 FILE-RENAME used invalid WILDCARDing LINE_NUMBER This returns the line number in the script file that the set command is on. DELAY __________________________________________________________________________ GIF-REED 95 __________________________________________________________________________ This returns the delay time for the slides to wait after showing the image. RESOLUTION This returns what resolution number is currently selected. It's only useful if RES-LOCK is turned on. The numbers range from 1 to ??. Usually there are about 3 to 6 resolutions available depending on your Super VGA capabilities. FILE_SIZE This returns the file size of the next file to be processed. IMAGE_COLORS This returns the number of colors in the file. This would be 2 for black & white pictures, 16 for 16 color files and 256 for 256 color files. If the image has 24BIT color then IMAGE_COLORS will have 24 stored in it. V_# Where # is 1 thru 10. This means you can set any variable to the value of any other variable. For example: "SET V2 V_1" This sets variable 2 to the value in variable 1. Commands To Point To A Path CHANGE-PATH {PATH, %1-%9) This command changes the path to load files from the path indicated by PATH. For example: "CHANGE-PATH *.GIF" would point the file list to the current directory. "CHANGE-PATH F:\PICTURES\*.GIF" would point to the F:\PICTURES directory and only select GIF files. NOTE: You can also use the %1 through %9 instead of a valid path. In this case the path will be taken from the program command line (very powerful!). So for example: C>GIFV /P:R G:\*.* E:\CAT\*.GIF If the script file called GIFV.SLR had a CHANGE-PATH %1 in it then "G:\*.*" would be used instead. If it had a CHANGE-PATH %2 then E:\CAT\*.GIF would be used. You can have up to 9 different selections. NOTE: As in the normal menu operation of GIF-REED, you can use the special wildcard of *.? to specify ALL image formats that GIF-REED recognizes. This is powerful in the fact that it is BETTER than using *.*. This is because *.* will get ALL files including files that aren't image files (.EXE, .COM, etc...). Commands To Do File Operations __________________________________________________________________________ 96 GIF-REED __________________________________________________________________________ FILE-COPY Destination LABEL This command allows you to take the next file in the list to be processed and copy it to a new filename or even a new drive and/or path. If there is an error in copying, control jumps to LABEL. See the system variable called FILE_ERROR. FILE-MOVE Destination LABEL This command allows you to take the next file in the list to be processed and move it to a new path or even a new drive and/or path. If there is an error in moving, control jumps to LABEL. See the system variable called FILE_ERROR. FILE-DELETE LABEL This command allows you to delete the next file to be processed. If there is an error in deleting, control jumps to LABEL. See the system variable called FILE_ERROR. FILE-RENAME FileName LABEL This command allows you to rename the next file to be processed. You can specify either a regular filename or you can WILDCARD the filename. See your DOS manual about WILDCARDS in filenames if you are not familiar with the term. For example "FILE-RENAME *.XXX" This would take the next file and rename it to the same filename but .XXX for the file extension! "FILE-RENAME X*.*" This would take the next file and rename it so that the 1st letter will be a X and the rest of the file name would remain intact! If there is an error in renaming, control jumps to LABEL. See the system variable called FILE_ERROR. SUB-CREATE {Path,%1-%9} LABEL This command creates a directory with the path specified by PATH. For example: "SUB-CREATE NEWGIFS" would create a subdirectory called NEWGIFS in the current path. You can change paths by issuing the CHANGE-PATH command. "SUB-CREATE E:\CAT :ERROR" would create a subdirectory called \CAT on the ROOT of drive E:. If there was an error in creating the directory, control jumps to LABEL. NOTE: You can also use the %1 through %9 instead of a valid path. In this case the path will be taken from the program command line (very powerful!). So for example: C>GIFV /P:R NEWGIFS E:\CATF If the script file called GIFV.SLR had a SUB-CREATE %1 in it then "NEWGIFS" would be used to create a directory instead of %1. If it had a SUB-CREATE %2 then E:\CAT would be used. You can have up to 9 different selections. Commands To Load Pictures LOAD filename __________________________________________________________________________ GIF-REED 97 __________________________________________________________________________ This command will load a specific picture file onto your screen. LOADNEXT LABEL This command loads the next file from the selected path used by the CHANGE-PATH PATH command. The picture is also displayed. If no more files exist (at end of list) control is transferred to LABEL. LOADPREV LABEL This command is similar to LOADNEXT except the files are loaded in reverse order. If you try to go too far backwards, control jumps to LABEL. SKIPNEXT LABEL The same as LOADNEXT except the picture is NOT displayed. The file pointer is merely incremented to point to the next file in the list. SKIPPREV LABEL The same as LOADPREV except the picture is NOT shown. The file pointer is merely decremented. Commands To Control Slide Show Effects SLIDE-TYPE-NORMAL This command puts the slide show into normal viewing mode. That is to say, NO special effects. SLIDE-TYPE-BLIND This command makes the images appear on the screen with a venetian blind effect. SLIDE-TYPE-FADE This command makes the images Fade IN/OUT on the screen. SLIDE-TYPE-EXPAND This command makes the images Expand on the screen. SLIDE-TYPE-MERGE This command makes the images Merge on the screen. SLIDE-TYPE-ZEBRA This command makes the images form like a Zebra. SLIDE-TYPE-RANDOM This command uses random slide show effects. Commands Used While Image Is Displayed CENTER This command centers the image on the screen __________________________________________________________________________ 98 GIF-REED __________________________________________________________________________ FLIP This command flips the image on the screen GRAY This command turns the image into a Black & White (B&W) picture. INVERT NEGATIVE These commands make the pictures look like a negative. The colors are reversed. MIRROR This command mirror images the picture on the screen. ROTATE This command rotates the image clockwise on your screen. REDRAW This command redraws the image on the screen in case you had echoed some text on the screen and got rid of the picture. RES+ RES- These commands increase and decrease the screen resolution in which the image is being displayed. PRINT This command prints the image to your printer. You must have an HP or EPSON compatible printer. The default printer configuration will be used to print all images. Make sure you have selected good default printer settings and have saved them with the ALT-U command from the main files list menu. WRITE {B,G,P,C} {1,2,3,filename} This command writes the current image to a file. If NO parameters are given, the current file format is used and the same name is used. If you specify "B" or "G" or "P" or "C" then a BMP or GIF or PCX or PIC will be written out to the same filename. For Example: WRITE B This would cause the current image displayed to be written out as a BMP file. This is great for converting files over to a different format! NOTE: If you select "G" without "filename" for a GIF file, you will NOT be able to add comments to the GIF file. If the GIF file had comments in it already, these would be kept in the file. If you use "filename", specify a file in the GIF-REED directory that contains the comments you want to add to the GIF file. For example: __________________________________________________________________________ GIF-REED 99 __________________________________________________________________________ WRITE G MYNOTES This would force the image to have, as comments, the information in the file called MYNOTES located in the GIF-REED directory. If the name of the file had .ADD as an extension, the comments would be added to any comments that may currently be in the file. For example: WRITE G MYNOTES.ADD This would keep any old comments in the original GIF file and add to them the text in the file called MYNOTES.ADD. If you want to INSERT your personal comments IN FRONT of any comments currently in the GIF file, you can use a filename with an extension of .INS. For example: WRITE G MYNOTES.INS This would insert the text found in MYNOTES.INS and insert before any comments found in the original GIF file. HINT HINT HINT It may not be readily apparent, but you can actually REMOVE all comments from GIF files by specifying a filename without any data in it. Then use the "WRITE G FILENAME" command in the script language. This would remove any current comments and add whatever text is in FILENAME (nothing of course). NOTE: If you select "P" or "C" for PCX or PIC file, a default of 256 color mode will be used to create the file. In order to specify 2 or 16 color mode, you can use the SECOND parameter of a 1,2 or 3. For example: WRITE P 2 This will write out a PCX file in 16 color mode. 1 indicates black and white (2 color mode). 2 indicates 16 color mode and 3 indicates 256 color mode. LESS-RED (While viewing CTRL-F1) MORE-RED (While viewing CTRL-F2) LESS-GREEN (While viewing CTRL-F3) MORE-GREEN (While viewing CTRL-F4) LESS-BLUE (While viewing CTRL-F5) MORE-BLUE (While viewing CTRL-F6) LESS-CONTRAST (While viewing CTRL-F7) MORE-CONTRAST (While viewing CTRL-F8) DARKER (While viewing CTRL-F9) BRIGHTER (While viewing CTRL-F10) LESS-REDDER (While viewing SHIFT-F1) MORE-REDDER (While viewing SHIFT-F2) __________________________________________________________________________ 100 GIF-REED __________________________________________________________________________ LESS-GREENER (While viewing SHIFT-F3) MORE-GREENER (While viewing SHIFT-F4) LESS-BLUER (While viewing SHIFT-F5) MORE-BLUER (While viewing SHIFT-F6) All of these commands alter the appearance of the image on the screen. You should be able to figure out what each command does. RESET-COLORS If you turned the image into B & W with the GRAY command or used the color alter commands above, you can reset the colors to the ORIGINAL colors with this command. SORT-COLORS SORT-COLORS allows you to sort the image's color-map. It sorts the color map with the most frequently used colors at the front of the color map. This is great for images being displayed in Windows because Windows GRABS the TOP 4-16 colors in every image's color map for display purposes. This produces FUNNY looking pictures if the picture used a lot of a particular color that Windows took and changed to its own liking! By sorting the color map, the least used colors are placed at the top. In fact, a lot of images don't use the full 256 colors available in the color map. This means most images wouldn't be disturbed by Windows because the colors used by Windows would be colors in the color map that weren't even used by the image! ADJUST-FOR-WINDOWS This command will take the current image (picture) file and strip off the TOP 16 colors in the image's color table. The colors in the image that used the TOP 16 colors in the color table will be substituted with the BEST match in the lower 240 colors in the color table. This produces results that are very close to the original image. A file processed by this command can then be used as a BMP file that Windows can use and display without distorting the image. The distortion that normally occurs when viewing a picture under Windows is because Windows will CHANGE the TOP 16 colors in the color table (map) of the image! By having the image NOT use the TOP 16 colors, the image will NOT be distorted while viewing under Windows! Commands To Control Printing PRINTER Filename The filename given forces all printer output to go to the file instead of the printer. LPT1, LPT2 or PRN can be used as filenames to revert back to printer output. The default directory for the filename is in the current directory. PRINTER-ON This command turns on the printer. Anything that gets displayed on the screen (except images) will be printed to __________________________________________________________________________ GIF-REED 101 __________________________________________________________________________ your printer. Things such as debug information, ECHO and DISPLAY items will be printed to your printer as well as being displayed on your screen. PRINTER-OFF This turns off the printer-on command. PRINTER-FF This command forces a Form-Feed on your printer. This means the last page will be ejected from your printer. Commands To Control Mouse Operations MOUSE-CONTROL-ON This turns on mouse control. When mouse control is ON, images are left on the screen until you click a mouse button. MOUSE-CONTROL-OFF This turns off the mouse control. Images are finished displaying after the specified time delays are reached. Commands To Control Debugging DEBUG-ON This command turns on the debug mode. Every line in the script is shown on the screen as the script is being executed. Also, useful information about your 10 variables are displayed. DEBUG-OFF This command turns OFF the debug mode. General Purpose Commands BEEP ### This command causes a beep to be heard. If you indicate a NUMBER, you will hear that many beeps. DELAY ### This indicates how many seconds to delay before going to the next picture. ENTER This command forces the user to press ENTER or RETURN. SYSTEM {DOS COMMAND} This command allow you to execute a DOS command. NOTE: If no parameter is specified then you will be SHELLED out to DOS. You will need to type EXIT at the DOS prompt to continue with the script file. TEXT This puts the screen into TEXT mode, if it isn't already. __________________________________________________________________________ 102 GIF-REED __________________________________________________________________________ WAIT ### This command waits for ### hundredths of a seconds. For example: "WAIT 500" would wait for 5 seconds and "WAIT 50" would wait for 1/2 a second. Commands That Change The NEXT Images Resolution RES ### This command indicates the current resolution to be displayed if res-locking is turned ON. NOTE: If a number larger than the number of possible resolutions is used, the largest resolution will be selected. RES-LOCK This forces all further images to load with the specified resolution from "RES" to be used. RES-UNLOCK This forces res-locking off. This is the default state and all images are displayed with the BEST resolution used. RES-UP This command increments the resolution that would be used for res-locking. RES-DOWN This command decrements the resolution that would be used for res-locking. EGA-MODE This command forces the picture to be loaded in EGA mode. This produces POOR results compared to VGA mode. You probably shouldn't ever use this command unless you plan on converting your 256 color images to 16 color EGA images. VGA-MODE This command forces the picture to be loaded in VGA mode. This is the default, unless you only have EGA capability. EGA-COLOR-ADJUST {ON,OFF} When viewing a picture in EGA mode, the normal process is to convert all of the colors into 16 color selection. This makes the picture viewable in EGA mode even though the picture may be a 256 color image. This is the normal mode of operation. However, if you only have EGA capability and wish to perform a script file that manipulates the picture (Gray scale, rotate, mirror, etc...) and then saves it back out, you may NOT want the colors adjusted. In order to preserve the VGA quality of the colors while operating the script on a machine with EGA only capability, you may want to use the "EGA-COLOR-ADJUST OFF" statement. This way you can process your files on a EGA system without losing the VGA quality of the picture! __________________________________________________________________________ GIF-REED 103 __________________________________________________________________________ KEEP-SCREEN-SIZE {ON,OFF} When using the WRITE command to write out GIF or PCX files, the original screen size is overwritten with whatever resolution mode you happen to be displaying the picture in. This means if you load a picture in a VGA system that only supports 320x200, when you go to write the GIF or PCX file, the 320x200 mode information is written to the file to indicate that it is to be displayed in 320x200 mode. This is NOT particularly good since the picture may be a 1024x768 picture. In this case, any viewer would set the mode to 320x200 and then display the picture. This means you won't see the whole picture! If you use the "KEEP-SCREEN-SIZE ON" statement, when the picture is written to a GIF or PCX file, the ORIGINAL screen size is kept intact. This means you can process and convert your images to GIF or PCX files on a VGA system with only 320x200 resolution and NOT have to worry about how the picture will load with image viewers. The same goes for older super VGA cards that only support 640x480. Basically, if your card doesn't support the resolution the picture was INTENDED to be displayed in, you should use the "KEEP-SCREEN-SIZE ON" statement if you plan on writing out GIF or PCX files. NOTE: BMP files do NOT have this problem!. This is because BMP files DON'T save the INTENDED RESOLUTION into the file. __________________________________________________________________________ 104 GIF-REED __________________________________________________________________________ GIF-REED HINTS Operation HINTS There are several things that you can do to make GIF-REED easier to use and operate. None of the items listed below really relate to one another, so I will discuss each one of them in no particular order. 1. If you register GIF-REED you won't have to type anything at the entry screen. It's also compiled with optimizations so it runs faster! 2. After you have entered the main screen, save out your video setup by pressing ALT-U at the main file list menu. This way GIF-REED will automatically know what kind of video board you have the next time you run it. This speeds up the time it takes to load the program. 3. If you have enough EMS memory, use it for the picture buffer, otherwise use XMS memory. If you don't have enough of either, use disk space. It's preferable that the disk space is on a RAM-DISK or a hard drive that is cached by a disk cache for maximum speed. PS. We sell an award winning disk cache called FLASH. It shares memory with all applications using EMS/XMS/DPMI and Windows memory. It even comes with a RAM-DISK that shares memory with the cache! See the section on Picture Buffer. 4. If you plan on doing a lot of cataloging, save your catalog options out with the ALT-U command at the main file list menu. This way you don't have to keep entering your options each time you run GIF-REED to do a catalog. 5. Make sure you have the maximum amount of DOS RAM when doing the catalog process to insure the maximum speed. The more DOS RAM, the FASTER the catalogs are generated. 6. Picking GRAY image catalogs produces catalogs FASTER and makes the resulting files SMALLER. 7. You get noticeably better results if you select a catalog size of 800x600 rather than a smaller size. However, if you choose 1024x768, the results aren't that much better than 800x600 and since 1024x768 catalogs take more time and more disk space, we suggest sticking with 800x600 catalogs unless you want to make huge catalogs of let's say 2048x1536. 8. If GIF-REED automatically detects your hardware, it makes NO SENSE to install a VESA VGA driver. It will NOT speed up or improve quality of images. All it will do is EAT up precious DOS RAM. Of course if you have other programs that need it, it's ok to use it! __________________________________________________________________________ GIF-REED 105 __________________________________________________________________________ 9. Use the F8 function from the main files list menu. This can get you more available DOS RAM for operations within GIF-REED. If your files list is huge (more than 1000) then this function can save you at least 50K of DOS RAM. Hardware HINTS In order for GIF-REED to operate as fast as possible, your hardware should be setup to operate as fast as possible. If your VGA board has the ability to operate at ZERO wait states, try it and see if it works. If so then great. Also make sure it's operating in 16BIT mode if it's a 16BIT card. Also make sure it's in a 16BIT slot if it's a 16BIT card. You can also go into your system CMOS setup and see if you have the ability to change your BUS speed. If you can, set it to the highest setting. You should be WARNED here and now that you should test ALL hardware in your system such as serial ports, network cards, hard drives, floppy drives etc. after changing the BUS speed. If any part of your system fails, slow the BUS down a little and retry test. Some CMOS setups allow you to change your wait states. Try changing your wait states to ZERO. Again, be WARNED that you should check out all hardware after making this change. Also, you should run some of your larger application software to make sure they still work. If you have problems, reset the system CMOS to the original values. __________________________________________________________________________ 106 GIF-REED __________________________________________________________________________ Trouble Shooting / Questions & Problems Q1. Why doesn't GIF-REED recognize my VGA Video Adapter card type? It says it can only support 320x200. A1. Since most VGA boards are different from one another, it is not possible for GIF-REED to be aware of EVERY card that is on the market. We try to support most of the MAJOR brands, but even still you might find a few that we just can't support. NOTE: Some of the earlier IBM PS model 2's only have standard VGA capabilities. Thus only 320x200 in 256 colors can be displayed. Of course, the many EGA resolutions of 16 colors are still supported. Q2. Why does my machine lock-up when GIF-REED is trying to do an automatic video configuration? A2. GIF-REED tries to determine what kind of video adapter card you have by drawing to the screen and then checking to see that what was drawn was what was supposed to be drawn. If it appears that the information was drawn correctly, then it assumes that you have a particular video card. It may be possible for GIF-REED to think you have one card when you may have another. In this case GIF-REED will try to fully manipulate the card. If the card was of the wrong type, your computer MAY lock up. To date I've only seen this happen ONCE! Q3. Why are RED WHITE and BLUE boxes drawn on the screen during the video configuration? A3. This is how GIF-REED can tell if you video card is supported. This is normal, just let it happen. Q4. What's an image file or a picture file? A4. Any file that can be displayed to look like a picture on your screen could be considered an image/picture file. The most popular formats are of course GIF, BMP, PCX and PIC. Other formats are used as well, such as IFF, TIFF, LBM and MAC. There are probably a few more that we are totally unaware of too! Q5. What's a picture buffer? A5. This is the holding area for the picture file after it's been read from the disk. This holding area should be fast so that moving the picture around on the screen can be fast. This area should be setup in EMS to be the fastest. XMS memory would be the next best __________________________________________________________________________ GIF-REED 107 __________________________________________________________________________ choice. And finally DISK would be the LAST choice to pick. See the Chapter on Picture Buffer. Q6. Why would I want to delete a resolution from my available choices using the F9 key at the main menu? A6. If your monitor doesn't support a particular mode of resolution available on your video card, you may get scrambled eggs on your screen that are totally unreadable. In order for GIF-REED to be aware that you don't want this mode available, just press F9 at the main menu and poof, that mode will disappear from the resolution list. You can then save this video configuration out using the ALT- U command. Q7. Why would I want to switch to EGA mode using the ALT-F7 key from the main menu? A7. You DON'T! The only reason EGA support is available on systems that already have VGA is so that you can see what an image would look like in the EGA mode! Q8. Why do I get "Error 2, Bad Gif Descriptor" error message on some of my files? A8. It's possible that certain files may appear to be GIF files when in fact they may just be simple text files that start with GIF8 as the first few letters in the DOC file. Of course you may also have a BAD GIF File! Q9. Why does GIF-REED say it can't open GIFV.GIF when it tries to get loaded? A9. The GIFV.GIF file is the logo screen. GIF-REED loads this picture onto the screen upon loading of the program. If it can't find the logo screen, it tells you about it! Q10. What exactly does the MAKEROM.EXE file do for me? A10. This program creates a file called VIDEO.ROM with the contents of your video ROM in it. This file should be shipped to us (Software Matters Inc.) for diagnostic purposes. This is in case we can't get GIF-REED to properly work with your video card. Q11. Why is it that when I view files in Windows the image doesn't look all correct? A11. Windows grabs the top 16 colors in the color map of the image. See the section "What is a Color Map" for a solution. __________________________________________________________________________ 108 GIF-REED __________________________________________________________________________ Q12. Why does my GIF-REED blow up when it tries to run and uses my TRIDENT Vesa driver? A12. The trident vesa driver is BUGGY! Have GIF-REED control your trident video card directly. You can do this with the GIFREED environment variable. Just type: SET GIFREED=TRIDENT at the DOS prompt. You can put this statement in your AUTOEXEC.BAT file too. This tells GIF-REED to IGNORE the vesa driver on the Trident video board. Q13. Why does the mouse seem to make the picture go to the next picture when I'm trying to mark a box? A13. You apparently are quickly clicking the mouse button. A quick click means Goto the next picture. If you HOLD DOWN on the mouse button, you will be able to mark a box! Q14. Why would I want to register GIF-REED? A14. So that you may have piece of mind!<<GRIN>> __________________________________________________________________________ GIF-REED 109 __________________________________________________________________________ Glossary Here is a list of terms that you may or may not know. If you knew them then you wasted 5 minutes of your time, otherwise you probably learned something you can make use of. CATALOG This term refers to a picture file that is made up of a bunch of other images. You can think of it as a page out of a photo album. On any one page you may see 4-8 pictures. COLOR MAP This term refers to the key that is used in decoding pictures. Most picture files are a series of numbers that range from 1 to 256. Each number corresponds to a slot in the color map. There are 256 entries in the color map. Each entry is made up of a Red, Green and Blue value. This way, we know how much Red, Green and Blue to put on the screen for each DOT. EMS MEMORY This memory can be found in older 8088 systems and 286 systems. Most 386 and 486 systems have EXTENDED memory only by default. In order to get EMS memory you must use programs such as EMM386.EXE, QEMM386.SYS or 386MAX.SYS to convert some or all of your EXTENDED memory to EMS memory. FILE FORMAT This refers to how a picture file is saved. NOT all picture files are created in the same way. The formats that GIF-REED support are: GIF BMP PCX PIC GIF COMMENTS Some GIF files have actual textual comments in them to give the user additional information about the file. This comment, which may be anywhere from a single line of text to many pages of text, can be viewed by GIF-REED. GIF87a The original specification for the GIF file. It is limited to a single image per file and NO comments can be stored in them. GIF89a This is an improvement over the GIF87a specification. It allows for simple animation, GIF comments and multiple images per GIF file. __________________________________________________________________________ 110 GIF-REED __________________________________________________________________________ IMAGE This is a file that is a graphic picture. It could be a scanned image of a CAR or like such. It could also be a line drawing that you may have created yourself in a graphics package. MARK This term is used when you highlight a file in the file list by pressing the SPACE BAR. You can also click the RIGHT mouse button to tag a file from the main file list menu. Some people use other terms such as tag or flag. PATH LIST This is a list of paths that GIF-REED looks in to get the list of filenames to appear on the screen to pick from. In otherwords, you can be looking at more than ONE directory at a time by having multiple paths in the path list. PICTURE This is a file that is a graphic image. It could be a scanned image of a CAR or like such. It could also be a line drawing that you may have created yourself in a graphics package. PIXEL EDITING This is the process of changing an individual DOT in an image. To change the DOT, you can change it's color. RESOLUTION This term is used to indicate how many dots are across and down your screen. 640x480 would mean 640 dots across and 480 dots up and down. The larger the resolution the better the picture looks on your screen. However, as the resolution goes up, the images looks smaller on your screen. RESOLUTION LOCKING This allows you to tell GIF-REED to ignore the automatic resolution detection and to use a specific resolution instead. SCRIPT This is a text file that gets executed. It's merely a list of commands that GIF-REED knows how to process. It's like batch files are to DOS. SLIDE SHOW A slide show is when many files are constantly being displayed on the screen with a specified delay in between each picture. There are many options to choose from in the GIF-REED slide show. TAG This term is used when you highlight a file in the file list by pressing the SPACE BAR. You can also click the RIGHT mouse button to tag a file from the main file list menu. Some people use other terms such as mark or flag. __________________________________________________________________________ GIF-REED 111 __________________________________________________________________________ VESA This term is used by VIDEO manufacturers to indicate their VGA board is compatible with the VESA standard. If your board supports VESA, GIF-REED will automatically work with your board. XMS MEMORY Most 286, 386 and 486 systems have EXTENDED memory only by default. In order to get XMS memory you must use programs such as HIMEM.SYS, QEMM386.SYS or 386MAX.SYS to convert ALL of your EXTENDED memory to XMS memory. ZIPPED When transferring files, it's nice to know that you received or sent the entire package. Instead of sending many files, it's easier to send one (1) file that represents the many files you would have sent. In order to mash all of the programs in the package into one file, you need to ZIP them up with a program called PKZIP.EXE. In order to break the one (1) file down into it's many original files, you need to UNZIP the file with PKUNZIP.EXE NOTE: PKZIP is a product of PKWARE and is a shareware product that is trademarked. __________________________________________________________________________